Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure Static Web Apps propose deux emplacements différents où les versions du runtime et du langage sont importantes, sur le front-end et pour l’API.
| Type de runtime | Descriptif |
|---|---|
| Front-end | Version responsable de l’exécution des étapes de génération du site web qui créent l’application frontale. |
| API | Version et runtime d’Azure Functions utilisés dans votre application web. |
Front-end
Vous pouvez spécifier la version utilisée pour générer le front end de votre application web statique. La configuration d’une version non par défaut est souvent nécessaire uniquement si vous devez cibler des versions antérieures.
Vous pouvez spécifier la version d'exécution qui génère la partie frontale de votre application web statique dans le fichier package.json dans la section engines du fichier.
{
...
"engines": {
"node": ">=14.0.0"
}
}
API (Interface de Programmation d'Applications)
La prise en charge sous-jacente des API dans Azure Static Web Apps est fournie par Azure Functions. Pour plus d’informations, reportez-vous aux langages et runtimes pris en charge par Azure Functions .
Les versions suivantes sont prises en charge pour les fonctions managées dans Static Web Apps. Si votre application nécessite une version non répertoriée, envisagez d’apporter vos propres fonctions à votre application.
Pour configurer la version du runtime de langage d’API, définissez la propriété apiRuntime de la section platform sur l’une des valeurs prises en charge suivantes.
| Version du runtime de langage | Système d’exploitation | Version d’Azure Functions | valeur apiRuntime |
Date de fin de prise en charge |
|---|---|---|---|---|
| .NET Core 3.1 | Fenêtres | 3.x | dotnet:3.1 |
3 décembre 2022 |
| .NET 6.0 in-process | Fenêtres | 4.x | dotnet:6.0 |
30 avril 2025 |
| .NET 8.0 in-process | Fenêtres | 4.x | dotnet:8.0 |
- |
| .NET 6.0 isolé | Fenêtres | 4.x | dotnet-isolated:6.0 |
30 avril 2025 |
| .NET 7.0 isolé | Fenêtres | 4.x | dotnet-isolated:7.0 |
30 avril 2025 |
| .NET 8.0 isolé | Fenêtres | 4.x | dotnet-isolated:8.0 |
- |
| .NET 9.0 isolé | Fenêtres | 4.x | dotnet-isolated:9.0 |
- |
| Node.js 12.x | Linux | 3.x | node:12 |
3 décembre 2022 |
| Node.js 14.x | Linux | 4.x | node:14 |
30 avril 2025 |
| Node.js 16.x | Linux | 4.x | node:16 |
30 avril 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 avril 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
Pour changer la version du runtime dans une application .NET, changez la valeur TargetFramework dans le fichier csproj. Bien que facultative, si vous définissez une valeur apiRuntime dans le fichier staticwebapp.config.json, vérifiez que la valeur correspond à ce que vous définissez dans le fichier csproj.
L’exemple suivant montre comment mettre à jour l’élément TargetFramework pour NET 8.0 comme version du runtime de langage d’API dans le fichier csproj.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
...
</PropertyGroup>
...
Node.js
L’exemple de configuration suivant montre comment utiliser la apiRuntime propriété pour sélectionner Node.js 20 comme version du runtime du langage d’API dans le fichier staticwebapp.config.json .
{
...
"platform": {
"apiRuntime": "node:20"
}
...
}
Python
L’exemple de configuration suivant montre comment utiliser la apiRuntime propriété pour sélectionner Python 3.11 comme version du runtime du langage API dans le fichier staticwebapp.config.json .
{
...
"platform": {
"apiRuntime": "python:3.11"
}
...
}
Réactiver les proxys dans v4.x
Azure Functions prend en charge la réactivation des proxys dans v4.x. Pour activer la prise en charge du proxy dans les fonctions gérées pour votre application web statique, définissez SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS sur true dans les paramètres de votre application.
Remarque
Bien que les proxys soient pris en charge dans v4.x, envisagez d’utiliser l’intégration de Gestion des API Azure à vos applications de fonction managées. Par conséquent, votre application ne dépend pas des proxys.
Dépréciations
Remarque
Maintenant qu’Azure Functions v3 est mis hors service, Static Web Apps utilise Azure Functions v4 pour la prise en charge du runtime d’API pour Python 3.8. Redéployez votre application pour activer cette modification. Bien qu'il ne soit pas recommandé, vous pouvez revenir à la version v3 en définissant la variable d'environnement USEV3_FOR_PYTHON38 sur true.
Les runtimes suivants sont déconseillés dans Azure Static Web Apps. Pour plus d’informations sur la modification de votre runtime, consultez Spécifier la version du runtime de langage d’API dans Azure Static Web Apps et Migrer des applications d’Azure Functions version 3.x vers la version 4.x.
- .NET Core 3.1
- Node.js 12.x