Podporované jazyky a moduly runtime ve službě Azure Static Web Apps

Azure Static Web Apps nabízí dva různé aspekty, kde jsou důležité verze runtime a jazyka: na front-endu a v případě API.

Typ modulu runtime	Popis
Front-end	Verze zodpovědná za spuštění kroků sestavení webu, které sestaví front-endovou aplikaci.
Rozhraní API	Verze a runtime služby Azure Functions použité ve vaší webové aplikaci.

Front-end

Můžete zadat verzi použitou k sestavení front-endu statické webové aplikace. Konfigurace jiné než výchozí verze je často nutná pouze v případě, že potřebujete cílit na starší verze.

Můžete zadat verzi modulu runtime, která sestaví front-end vaší statické webové aplikace v souborupackage.json v engines části souboru.

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

API

Azure Functions poskytuje základní podporu rozhraní API ve službě Azure Static Web Apps. Podrobnosti najdete v podporovaných jazycích a runtimech Azure Functions.

Pro spravované funkce ve Static Web Apps se podporují následující verze. Pokud vaše aplikace vyžaduje verzi, která není uvedená, zvažte možnost přivést do aplikace vlastní funkce .

Pokud chcete nakonfigurovat verzi modulu runtime jazyka API, nastavte apiRuntime vlastnost v platform části na jednu z následujících podporovaných hodnot.

Verze běhového prostředí jazyka	Operační systém	Verze „Azure Functions“	apiRuntime hodnota	Datum ukončení podpory
.NET Core 3.1	Windows	3.x	dotnet:3.1	sobota 3. prosince 2022
.NET 6.0 v procesu	Windows	4.x	dotnet:6.0	30. dubna 2025
.NET 8.0 v průběhu	Windows	4.x	dotnet:8.0	-
Izolované prostředí .NET 6.0	Windows	4.x	dotnet-isolated:6.0	30. dubna 2025
Izolované rozhraní .NET 7.0	Windows	4.x	dotnet-isolated:7.0	30. dubna 2025
Izolované rozhraní .NET 8.0	Windows	4.x	dotnet-isolated:8.0	-
Izolované prostředí .NET 9.0	Windows	4.x	dotnet-isolated:9.0	-
Node.js 12.x	Operační systém Linux	3.x	node:12	sobota 3. prosince 2022
Node.js 14.x	Operační systém Linux	4.x	node:14	30. dubna 2025
Node.js 16.x	Operační systém Linux	4.x	node:16	30. dubna 2025
Node.js 18.x	Operační systém Linux	4.x	node:18	31. května 2025
Node.js 20.x	Operační systém Linux	4.x	node:20	-
Node.js 22.x	Operační systém Linux	4.x	node:22	-
Python 3.8	Operační systém Linux	4.x	python:3.8	30. dubna 2025
Python 3.9	Operační systém Linux	4.x	python:3.9	-
Python 3.10	Operační systém Linux	4.x	python:3.10	-
Python 3.11	Operační systém Linux	4.x	python:3.11	-

platforma .NET

Pokud chcete změnit verzi modulu runtime v aplikaci .NET, změňte TargetFramework hodnotu v souboru csproj . I když je to volitelné, pokud nastavíte hodnotu apiRuntime v souboru staticwebapp.config.json, ujistěte se, že hodnota odpovídá tomu, co definujete v souboru csproj.

Následující příklad ukazuje, jak aktualizovat TargetFramework element pro NET 8.0 jako verzi modulu runtime jazyka API v souboru csproj .

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

Node.js

Následující příklad konfigurace ukazuje, jak pomocí apiRuntime vlastnosti vybrat Node.js 20 jako verzi modulu runtime jazyka API v souborustaticwebapp.config.json .

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

Python

Následující příklad konfigurace ukazuje, jak pomocí apiRuntime vlastnosti vybrat Python 3.11 jako verzi modulu runtime jazyka API v souborustaticwebapp.config.json .

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

Opětovné povolení proxy serverů ve verzi 4.x

Azure Functions podporuje opětovné povolení proxy serverů ve verzi 4.x. Pro povolení podpory proxy serveru ve spravovaných funkcích pro statickou webovou aplikaci nastavte SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS na true v nastavení aplikace.

Poznámka:

I když jsou proxy podporované ve verzi 4.x, zvažte použití integrace služby Azure API Management s vašimi spravovanými aplikacemi funkcí, takže vaše aplikace není závislá na proxy serverech.

Znehodnocení

Poznámka:

Teď, když je Služba Azure Functions v3 vyřazená, používá Static Web Apps pro podporu modulu runtime rozhraní API pro Python 3.8 službu Azure Functions v4. Znovu nasaďte aplikaci, aby se tato změna povolila. I když se nedoporučuje, můžete se vrátit na verzi 3 nastavením proměnné USEV3_FOR_PYTHON38 prostředí na hodnotu true.

Následující runtime jsou ve službě Azure Static Web Apps zastaralé. Další informace o změně modulu runtime najdete v tématu Určení verze modulu runtime jazyka API ve službě Azure Static Web Apps a migraci aplikací z Azure Functions verze 3.x na verzi 4.x.

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