Språk och körtidsmiljöer som stöds i Azure Static Web Apps

Azure Static Web Apps har två olika platser där körning och språkversioner är viktiga, i klientdelen och för API:et.

Frontend

Du kan ange vilken version som används för att skapa klientdelen av din statiska webbapp. Det är ofta bara nödvändigt att konfigurera en icke-standardversion om du behöver rikta in dig på äldre versioner.

Du kan ange den körningsversion som bygger klientdelen av din statiska webbapp i package.json-filen i engines avsnittet i filen.

{
  ...
  "engines": {
   "node": ">=14.0.0"
  }
}

API (gränssnitt för programmering av applikationer)

Det underliggande stödet för API:er i Azure Static Web Apps tillhandahålls av Azure Functions. Se de språk och körningsmiljöer som stöds av Azure Functions för detaljer.

Följande versioner stöds för hanterade funktioner i Static Web Apps. Om ditt program kräver en version som inte visas kan du överväga att ta med dina egna funktioner till din app.

Om du vill konfigurera api-språkkörningsversionen anger du apiRuntime egenskapen i platform avsnittet till något av följande värden som stöds.

.NÄT

För att ändra runtime-versionen i en .NET-app, ändra TargetFramework värdet i csproj-filen och ställ in apiRuntime värdet i staticwebapp.config.json-filen till matchande version. Se till att apiRuntime-värdet stämmer överens med det du definierar i csproj-filen.

.NET 10.0 stöds endast med den isolerade arbetsmodellen. Om ditt API använder in-process-modellen, migrera först till den isolerade arbetsmodellen. För de paket och projektinställningar som krävs för att rikta in sig på .NET 10.0, se Guide för att köra C# Azure Functions i den isolerade arbetarmodellen.

Följande exempel visar hur man uppdaterar elementet TargetFramework för .NET 10.0 som runtimeversion för API-språket i csproj-filen.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    ...
  </PropertyGroup>
...

Följande exempelkonfiguration visar hur man använder egenskapen apiRuntime för att välja .NET 10.0 isolated som API-språkets runtime-version i staticwebapp.config.json-filen.

{
  ...
  "platform": {
    "apiRuntime": "dotnet-isolated:10.0"
  }
  ...
}

Node.js

Följande exempelkonfiguration visar hur du använder apiRuntime egenskapen för att välja Node.js 20 som API-språkkörningsversion i staticwebapp.config.json-filen .

{
  ...
  "platform": {
    "apiRuntime": "node:20"
  }
  ...
}

python

Följande exempelkonfiguration visar hur du använder apiRuntime egenskapen för att välja Python 3.11 som API-språkkörningsversion i staticwebapp.config.json-filen .

{
  ...
  "platform": {
    "apiRuntime": "python:3.11"
  }
  ...
}

Återaktivera proxyservrar i v4.x

Azure Functions stöder återaktivering av proxyservrar i v4.x. Om du vill aktivera proxystöd i hanterade funktioner för din statiska webbapp anger du SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS till true i dina programinställningar.

Utfasningar

Följande runtime-miljöer är föråldrade i Azure Static Web Apps. Mer information om hur du ändrar körningen finns i Ange API-språkkörningsversion i Azure Static Web Apps och Migrera appar från Azure Functions version 3.x till version 4.x.

• .NET Core 3.1
• Node.js 12.x