Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure Static Web Apps bietet zwei verschiedene Orte, an denen Laufzeit- und Sprachversionen wichtig sind, auf dem Front-End und für die API.
| Runtimetyp | BESCHREIBUNG |
|---|---|
| Front-End | Die Version, die für die Ausführung der Buildschritte der Website verantwortlich ist, die die Front-End-Anwendung erstellen. |
| API | Die Version und Laufzeit von Azure Functions, die in Ihrer Webanwendung verwendet werden. |
Front-End
Sie können die Version angeben, mit der das Front-End Ihrer statischen Web-App erstellt wird. Das Konfigurieren einer nicht standardmäßigen Version ist häufig nur erforderlich, wenn Sie ältere Versionen als Ziel verwenden müssen.
Sie können die Laufzeitversion angeben, die das Front-End Ihrer statischen Web-App in der package.json Datei im engines Abschnitt der Datei erstellt.
{
...
"engines": {
"node": ">=14.0.0"
}
}
Programmierschnittstelle (API)
Die zugrunde liegende Unterstützung für APIs in Azure Static Web Apps wird von Azure Functions bereitgestellt. Ausführliche Informationen finden Sie in den unterstützten Sprachen und Laufzeiten von Azure Functions .
Die folgenden Versionen werden für verwaltete Funktionen in Static Web Apps unterstützt. Wenn Ihre Anwendung eine nicht aufgeführte Version erfordert, ziehen Sie in Betracht, Ihre eigenen Funktionen in Ihre App zu integrieren.
Legen Sie zum Konfigurieren der Version der API-Sprachlaufzeit die apiRuntime-Eigenschaft im platform-Abschnitt auf einen der folgenden unterstützten Werte fest.
| Language-Laufzeitversion | Betriebssystem | Azure Functions-Version |
apiRuntime-Wert |
Enddatum des Supports |
|---|---|---|---|---|
| .NET Core 3.1 | Fenster | 3.x | dotnet:3.1 |
3. Dezember 2022 |
| .NET 6.0 (In-Process) | Fenster | 4.x | dotnet:6.0 |
30. April 2025 |
| .NET 8.0 im Prozess | Fenster | 4.x | dotnet:8.0 |
10. November 2026 |
| .NET 6.0 (isoliert) | Fenster | 4.x | dotnet-isolated:6.0 |
30. April 2025 |
| .NET 7.0 (isoliert) | Fenster | 4.x | dotnet-isolated:7.0 |
30. April 2025 |
| .NET 8.0 (isoliert) | Fenster | 4.x | dotnet-isolated:8.0 |
10. November 2026 |
| .NET 9.0 im isolierten Modus | Fenster | 4.x | dotnet-isolated:9.0 |
10. November 2026 |
| .NET 10.0 isolated | Fenster | 4.x | dotnet-isolated:10.0 |
- |
| Node.js 12.x | Linux | 3.x | node:12 |
3. Dezember 2022 |
| Node.js 14.x | Linux | 4.x | node:14 |
30. April 2025 |
| Node.js 16.x | Linux | 4.x | node:16 |
30. April 2025 |
| Node.js 18.x | Linux | 4.x | node:18 |
31. Mai 2025 |
| Node.js 20.x | Linux | 4.x | node:20 |
- |
| Node.js 22.x | Linux | 4.x | node:22 |
- |
| Python 3.8 | Linux | 4.x | python:3.8 |
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 |
- |
.NET
Um die Laufzeitversion in einer .NET-App zu ändern, ändern Sie den TargetFramework Wert in der csproj-Datei und setzen Sie den apiRuntime Wert in der staticwebapp.config.json-Datei auf die passende Version. Stelle sicher, dass der apiRuntime Wert mit dem übereinstimmt, was du in der csproj-Datei definiert hast.
.NET 10.0 wird nur mit dem isolierten Worker-Modell unterstützt. Wenn deine API das In-Process-Modell verwendet, migriere zuerst auf das isolierte Worker-Modell . Für die Pakete und Projekteinstellungen, die zur Zielsetzung von .NET 10.0 erforderlich sind, siehe Leitfaden zum Ausführen von C# Azure Functions im isolierten Arbeitermodell.
Das folgende Beispiel zeigt, wie man das TargetFramework Element für .NET 10.0 als API-Laufzeitversion in der csproj-Datei aktualisiert.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
...
</PropertyGroup>
...
Die folgende Beispielkonfiguration zeigt, wie die apiRuntime-Eigenschaft verwendet wird, um .NET 10.0 isolated als API-Sprachlaufzeitversion in der Datei staticwebapp.config.json auszuwählen.
{
...
"platform": {
"apiRuntime": "dotnet-isolated:10.0"
}
...
}
Node.js
Die folgende Beispielkonfiguration veranschaulicht, wie Sie die apiRuntime Eigenschaft verwenden, um Node.js 20 als API-Sprachlaufzeitversion in der staticwebapp.config.json Datei auszuwählen.
{
...
"platform": {
"apiRuntime": "node:20"
}
...
}
Python
Die folgende Beispielkonfiguration veranschaulicht, wie die Eigenschaft zum Auswählen von apiRuntime Python 3.11 als API-Sprachlaufzeitversion in der dateistaticwebapp.config.json verwendet wird.
{
...
"platform": {
"apiRuntime": "python:3.11"
}
...
}
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, setzen Sie SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS auf true in Ihren Anwendungseinstellungen.
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 eingestellt wurde, verwendet Static Web Apps Azure Functions v4 für die API-Laufzeitunterstützung für Python 3.8. Stellen Sie Ihre App erneut bereit, um diese Änderung zu aktivieren. Obwohl es nicht empfohlen wird, können Sie auf v3 zurückkehren, indem Sie die Umgebungsvariable USEV3_FOR_PYTHON38 auf true setzen.
Die folgenden Laufzeiten sind in Azure Static Web Apps veraltet. Weitere Informationen zum Ändern der Laufzeit finden Sie unter Angeben der API-Sprachlaufzeitversion in Azure Static Web Apps und Migrieren von Apps von Azure Functions, Version 3.x zu Version 4.x.
- .NET Core 3.1
- Node.js 12.x