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 |
- |
| .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 |
- |
| .NET 9.0 im isolierten Modus | Fenster | 4.x | dotnet-isolated:9.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 |
- |
| 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 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, 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