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

2025-04-04

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

Körningstyp	Beskrivning
Frontend	Versionen som ansvarar för att köra webbplatsens byggsteg som bygger frontend-applikationen.
API	Versionen och körningen av Azure Functions som används i ditt webbprogram.

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.

Versions av språkens körmiljö	Operativsystem	Azure Functions-version	`apiRuntime` värde	Slutdatum för underhållsstöd
.NET Core 3.1	Windows	3.x	`dotnet:3.1`	3 december 2022
.NET 6.0 pågår	Windows	4.x	`dotnet:6.0`	den 30 april 2025
.NET 8.0 pågår	Windows	4.x	`dotnet:8.0`	-
.NET 6.0 isolerad	Windows	4.x	`dotnet-isolated:6.0`	den 30 april 2025
.NET 7.0 isolerad	Windows	4.x	`dotnet-isolated:7.0`	den 30 april 2025
.NET 8.0 isolerad	Windows	4.x	`dotnet-isolated:8.0`	-
.NET 9.0 i isolerat läge	Windows	4.x	`dotnet-isolated:9.0`	-
Node.js 12.x	Linux	3.x	`node:12`	3 december 2022
Node.js 14.x	Linux	4.x	`node:14`	den 30 april 2025
Node.js 16.x	Linux	4.x	`node:16`	den 30 april 2025
Node.js 18.x	Linux	4.x	`node:18`	31 maj 2025
Node.js 20.x	Linux	4.x	`node:20`	-
Python 3.8	Linux	4.x	`python:3.8`	den 30 april 2025
Python 3.9	Linux	4.x	`python:3.9`	-
Python 3.10	Linux	4.x	`python:3.10`	-
Python 3.11	Linux	4.x	`python:3.11`	-

.NÄT

Om du vill ändra körningsversionen i en .NET-app ändrar du TargetFramework värdet i csproj-filen . Om du anger ett apiRuntime värde i filen staticwebapp.config.json är det valfritt, men se till att värdet matchar det du definierar i csproj-filen .

I följande exempel visas hur du uppdaterar elementet TargetFramework för NET 8.0 som API-språkkörningsversion i csproj-filen .

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

Node.js

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

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

Python

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

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

Å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.

Anmärkning

Proxyservrar stöds i v4.x, men överväg att använda Azure API Management-integrering med dina hanterade funktionsappar, så att din app inte är beroende av proxyservrar.

Utfasningar

Anmärkning

Nu när Azure Functions v3 har dragits tillbaka använder Static Web Apps Azure Functions v4 för API-körningsstöd för Python 3.8. Distribuera om din app för att aktivera den här ändringen. Även om det inte rekommenderas kan du återgå till v3 genom att ställa in miljövariabeln USEV3_FOR_PYTHON38 på true.

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

Dela via