Ondersteunde talen en runtimes in Azure Static Web Apps

Azure Static Web Apps heeft twee verschillende locaties waar runtime- en taalversies belangrijk zijn, aan de front-end en voor de API.

Front-end

U kunt de versie opgeven die wordt gebruikt om de front-end van uw statische web-app te bouwen. Het configureren van een niet-standaardversie is vaak alleen nodig als u oudere versies wilt instellen.

U kunt de runtimeversie opgeven waarmee de front-end van uw statische web-app wordt gebouwd in het package.json-bestand in de engines sectie van het bestand.

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

API (Application Programming Interface)

De onderliggende ondersteuning voor API's in Azure Static Web Apps wordt geleverd door Azure Functions. Raadpleeg de ondersteunde talen en runtimes van Azure Functions voor meer informatie.

De volgende versies worden ondersteund voor beheerde functies in Static Web Apps. Als uw toepassing een versie vereist die niet wordt vermeld, kunt u overwegen om uw eigen functies naar uw app te brengen.

Als u de runtimeversie van de API-taal wilt configureren, stelt u de apiRuntime eigenschap in de platform sectie in op een van de volgende ondersteunde waarden.

.NET

Om de runtime-versie in een .NET-app te wijzigen, verander je de TargetFramework waarde in het csproj-bestand en stel je de apiRuntime waarde in het staticwebapp.config.json-bestand in op de bijbehorende versie. Zorg ervoor dat de waarde van apiRuntime overeenkomt met wat je definieert in het csproj-bestand.

.NET 10.0 wordt alleen ondersteund met het geïsoleerde worker-model. Als je API het in-process model gebruikt, migreer dan eerst naar het geïsoleerde worker-model. Voor de pakketten en projectinstellingen die nodig zijn om .NET 10.0 te targeten, zie Gids voor het uitvoeren van C# Azure Functions in het geïsoleerde werkermodel.

Het volgende voorbeeld laat zien hoe het TargetFramework-element voor .NET 10.0, dat de API-taalruntimeversie vertegenwoordigt, in het csproj-bestand kan worden bijgewerkt.

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

De volgende voorbeeldconfiguratie laat zien hoe je de apiRuntime eigenschap kunt gebruiken om .NET 10.0 te selecteren als de geïsoleerde API-taalruntimeversie in het staticwebapp.config.json-bestand.

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

Node.js

In de volgende voorbeeldconfiguratie ziet u hoe u de apiRuntime eigenschap gebruikt om Node.js 20 te selecteren als de runtimeversie van de API-taal in het staticwebapp.config.json-bestand .

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

Python

In de volgende voorbeeldconfiguratie ziet u hoe u de apiRuntime eigenschap gebruikt om Python 3.11 te selecteren als de runtimeversie van de API-taal in het staticwebapp.config.json-bestand .

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

Proxy's opnieuw inschakelen in v4.x

Azure Functions biedt ondersteuning voor het opnieuw inschakelen van proxy's in v4.x. Als u proxyondersteuning wilt inschakelen in beheerde functies voor uw statische web-app, stelt u deze in SWA_ENABLE_PROXIES_MANAGED_FUNCTIONStrue op in de toepassingsinstellingen.

Verouderingen

De volgende runtimes zijn afgeschaft in Azure Static Web Apps. Zie De runtimeversie van api-taal opgeven in Azure Static Web Apps en apps migreren van Azure Functions versie 3.x naar versie 4.x voor meer informatie over het wijzigen van uw runtime.

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