Azure Static Web Apps'te desteklenen diller ve çalışma zamanları

Azure Static Web Apps, ön uçta ve API için çalışma zamanı ve dil sürümlerinin önemli olduğu iki farklı yere sahiptir.

Çalışma zamanı türü	Açıklama
Ön uç	Web sitesinin ön uç uygulamasını oluşturan derleme adımlarını çalıştırmakla sorumlu sürüm.
API	Web uygulamanızda kullanılan Azure İşlevleri sürümü ve çalışma zamanı.

Ön uç

Statik web uygulamanızın ön ucunu oluşturmak için kullanılan sürümü belirtebilirsiniz. Varsayılan olmayan bir sürümün yapılandırılması genellikle yalnızca eski sürümleri hedeflemeniz gerektiğinde gereklidir.

Statik web uygulamanızın ön ucunu oluşturan çalışma zamanı sürümünü, dosyanın bölümündeki package.json dosyasında engines belirtebilirsiniz.

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

Uygulama Programlama Arayüzü (API)

Azure Static Web Apps'teki API'ler için temel alınan destek Azure İşlevleri tarafından sağlanır. Ayrıntılar için Azure İşlevleri tarafından desteklenen dillere ve çalışma zamanlarına bakın.

Statik Web Apps'teki yönetilen işlevler için aşağıdaki sürümler desteklenir. Uygulamanız listelenmeyen bir sürüm gerektiriyorsa, kendi işlevlerinizi uygulamanıza getirmeyi göz önünde bulundurun.

API dili çalışma zamanı sürümünü yapılandırmak için apiRuntime bölümündeki platform özelliğini aşağıdaki desteklenen değerlerden birine ayarlayın.

Dil çalışma zamanı sürümü	İşletim sistemi	Azure İşlevleri sürümü	apiRuntime değeri	Destek sonu tarihi
.NET Core 3.1	Windows	3.x	dotnet:3.1	3 Aralık 2022 Cumartesi
.NET 6.0 işlemde	Windows	4.x	dotnet:6.0	30 Nisan 2025
.NET 8.0 işlemde	Windows	4.x	dotnet:8.0	10 Kasım 2026
.NET 6.0 yalıtılmış	Windows	4.x	dotnet-isolated:6.0	30 Nisan 2025
.NET 7.0 yalıtılmış	Windows	4.x	dotnet-isolated:7.0	30 Nisan 2025
.NET 8.0 yalıtılmış	Windows	4.x	dotnet-isolated:8.0	10 Kasım 2026
.NET 9.0 yalıtılmış	Windows	4.x	dotnet-isolated:9.0	10 Kasım 2026
.NET 10.0 izole	Windows	4.x	dotnet-isolated:10.0	-
Node.js 12.x	Linux işletim sistemi	3.x	node:12	3 Aralık 2022 Cumartesi
Node.js 14.x	Linux işletim sistemi	4.x	node:14	30 Nisan 2025
Node.js 16.x	Linux işletim sistemi	4.x	node:16	30 Nisan 2025
Node.js 18.x	Linux işletim sistemi	4.x	node:18	31 Mayıs 2025
Node.js 20.x	Linux işletim sistemi	4.x	node:20	-
Node.js 22.x	Linux işletim sistemi	4.x	node:22	-
Python 3.8	Linux işletim sistemi	4.x	python:3.8	30 Nisan 2025
Python 3.9	Linux işletim sistemi	4.x	python:3.9	-
Python 3.10	Linux işletim sistemi	4.x	python:3.10	-
Python 3.11	Linux işletim sistemi	4.x	python:3.11	-

.NET

.NET uygulamasında çalışma zamanı sürümünü değiştirmek için, TargetFramework dosyasındaki değerini değiştirin ve apiRuntime dosyasındaki değerini eşleşen sürüme ayarlayın. Değerin apiRuntimecsproj dosyasında tanımladığınızla eşleştiğinden emin olun.

.NET 10.0 yalnızca izole çalışan modeliyle desteklenir. API'niz işlem içi modeli kullanıyorsa, önce izole çalışan modeline geçiş yapın. .NET 10.0'ı hedeflemek için gereken paketler ve proje ayarları için, izole işçi modelinde C# Azure İşlevleri'ı çalıştırmak için Rehber'e bakınız.

Aşağıdaki örnek, .NET 10.0 için, TargetFramework dosyasında API dili çalışma zamanı sürümü olarak öğesinin nasıl güncelleneceğini gösterir.

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

Aşağıdaki örnek yapılandırma, API dili çalışma zamanı sürümü olarak izole edilmiş .NET 10.0'ı seçmek için bu özelliğin apiRuntime dosyasında nasıl kullanılacağını gösterir.

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

Node.js

Aşağıdaki örnek yapılandırma, apiRuntime dili çalışma zamanı sürümü olarak Node.js 20'yi seçmek için özelliğinin nasıl kullanılacağını gösterir.

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

Piton

Aşağıdaki örnek yapılandırma, apiRuntime dosyasında API dili çalışma zamanı sürümü olarak Python 3.11'i seçmek için özelliğinin nasıl kullanılacağını gösterir.

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

v4.x'te proxy'leri yeniden etkinleştirme

Azure İşlevleri , v4.x'te proxy'lerin yeniden etkinleştirilmesini destekler. Yönetilen işlevlerde statik web uygulamanız için ara sunucu desteğini etkinleştirmek amacıyla, uygulama ayarlarınızda SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS ayarını true olarak yapın.

Uyarı

Proxy'ler v4.x'te destekleniyor olsa da, uygulamanızın proxy'lere bağlı olmadığından yönetilen işlev uygulamalarınızla Azure API Management tümleştirmesini kullanmayı göz önünde bulundurun.

Kullanımdan Kaldırmalar

Uyarı

Azure İşlevleri v3 kullanımdan kaldırıldığına göre, Static Web Apps Python 3.8 için API çalışma zamanı için Azure İşlevleri v4'lerini kullanıyor. Bu değişikliği etkinleştirmek için uygulamanızı yeniden dağıtin. Önerilmez ancak ortam değişkenini USEV3_FOR_PYTHON38 olarak ayarlayarak v3'e truegeri dönebilirsiniz.

Aşağıdaki çalışma zamanları Azure Static Web Apps'te kullanım dışıdır. Çalışma zamanınızı değiştirme hakkında daha fazla bilgi için bkz. Azure Static Web Apps'te API dil çalışma zamanı sürümünü belirtme ve Uygulamaları Azure İşlevleri sürüm 3.x'ten sürüm 4.x'e geçirme.

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