Unterstützte Sprachen und Runtimes in Azure Static Web Apps

Artikel
05/28/2024

In Azure Static Web Apps gibt es zwei verschiedene Stellen, an denen Runtime- und Sprachversionen wichtig sind: im Front-End und für die API.

Runtimetyp	Beschreibung
Front-End	Die Version, die für die Ausführung der Website-Buildschritte zum Erstellen der Front-End-Anwendung zuständig ist.
API	Die Version und Runtime von Azure Functions, die in Ihrer Webanwendung verwendet werden.

Front-End

Sie können die Version angeben, die zum Erstellen des Front-Ends Ihrer statischen Web-App verwendet wird. Das Konfigurieren einer nicht standardmäßigen Version ist häufig nur erforderlich, wenn Sie ältere Versionen verwenden müssen.

Sie können die Runtimeversion, die das Front-End Ihrer statischen Web-App erstellt, in der Datei package.json im Abschnitt engines der Datei angeben.

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

API

Die zugrunde liegende Unterstützung für APIs in Azure Static Web Apps wird von Azure Functions bereitgestellt. Weitere Informationen finden Sie unter Von Azure Functions unterstützte Sprachen und Runtimes.

Die folgenden Versionen werden für verwaltete Funktionen in Static Web Apps unterstützt. Wenn Ihre Anwendung eine nicht aufgeführte Version erfordert, können Sie erwägen, Ihre eigenen Funktionen in Ihre App einzubringen.

Legen Sie zum Konfigurieren der Version der API-Sprachlaufzeit die apiRuntime-Eigenschaft im platform-Abschnitt auf einen der folgenden unterstützten Werte fest.

Version der Sprachlaufzeit	Betriebssystem	Azure Functions-Version	Wert vom Typ `apiRuntime`	Supportende
.NET Core 3.1	Windows	3.x	`dotnet:3.1`	3\. Dezember 2022
.NET 6.0 (In-Process)	Windows	4.x	`dotnet:6.0`	-
.NET 6.0 (isoliert)	Windows	4.x	`dotnet-isolated:6.0`	-
.NET 7.0 (isoliert)	Windows	4.x	`dotnet-isolated:7.0`	-
.NET 8.0 (isoliert)	Windows	4.x	`dotnet-isolated:8.0`	-
Node.js 12.x	Linux	3.x	`node:12`	3\. Dezember 2022
Node.js 14.x	Linux	4.x	`node:14`	-
Node.js 16.x	Linux	4.x	`node:16`	-
Node.js 18.x	Linux	4.x	`node:18`	-
Node.js 20.x (Preview)	Linux	4.x	`node:20`	-
Python 3.8	Linux	4.x	`python:3.8`	-
Python 3.9	Linux	4.x	`python:3.9`	-
Python 3.10	Linux	4.x	`python:3.10`	-

.NET

Um die Runtimeversion in einer .NET-App zu ändern, ändern Sie den TargetFramework-Wert in der CSPROJ-Datei. Obwohl dies optional ist, sollten Sie, wenn Sie einen apiRuntime-Wert in der Datei staticwebapp.config.json festlegen, sicherstellen, dass der Wert mit dem übereinstimmt, den Sie in der CSPROJ-Datei definieren.

Im folgenden Beispiel wird veranschaulicht, wie das TargetFramework-Element für NET 8.0 als API-Sprachruntimeversion in der CSPROJ-Datei aktualisiert wird.

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

Node.js

Die folgende Beispielkonfiguration veranschaulicht die Verwendung der apiRuntime-Eigenschaft, um Node.js 16 als Version der API-Sprachruntime in der staticwebapp.config.json-Datei auszuwählen.

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

Python

Die folgende Beispielkonfiguration veranschaulicht die Verwendung der apiRuntime-Eigenschaft, um Python 3.8 als Version der API-Sprachruntime in der staticwebapp.config.json-Datei auszuwählen.

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

Erneutes Aktivieren von Proxys in v4.x

Azure Functions unterstützt die erneute Aktivierung von Proxys in v4.x. Um die Proxyunterstützung in verwalteten Funktionen für Ihre statische Web-App zu aktivieren, legen Sie SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS in den Anwendungseinstellungen auf true fest.

[!HINWEIS] Während Proxys in v4.x unterstützt werden, erwägen Sie die Verwendung der Azure API Management-Integration in Ihre verwalteten Funktions-Apps, sodass Ihre App nicht auf Proxys angewiesen ist.

Veraltete Funktionen

Hinweis

Nachdem Azure Functions v3 nun eingestellt wurde, verwendet Static Web Apps Azure Functions v4 für die Unterstützung der API-Runtime für Python 3.8. Stellen Sie Ihre App erneut bereit, um diese Änderung zu aktivieren. Obwohl nicht empfohlen, können Sie zu v3 zurückkehren, indem Sie die Umgebungsvariable USEV3_FOR_PYTHON38 auf true festlegen.

Die folgenden Runtimes sind in Azure Static Web Apps veraltet. Weitere Informationen zum Ändern der Runtime finden Sie unter Angeben der API-Sprachruntimeversion in Azure Static Web Apps und unter Migrieren von Apps von Azure Functions-Version 3.x zu Version 4.x.

.NET Core 3.1
Node.js 12.x

Freigeben über