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

Makale
05/28/2024

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"
  }
}

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 desteklenen Azure İşlevleri 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 bölümündeki özelliğini platform aşağıdaki desteklenen değerlerden birine ayarlayınapiRuntime.

Dil çalışma zamanı sürümü	İşletim sistemi	Azure İşlevleri sürümü	`apiRuntime` Değer	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`	-
.NET 6.0 yalıtılmış	Windows	4.x	`dotnet-isolated:6.0`	-
.NET 7.0 yalıtılmış	Windows	4.x	`dotnet-isolated:7.0`	-
.NET 8.0 yalıtılmış	Windows	4.x	`dotnet-isolated:8.0`	-
Node.js 12.x	Linux	3.x	`node:12`	3 Aralık 2022 Cumartesi
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 (önizleme)	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

.NET uygulamasında çalışma zamanı sürümünü değiştirmek için csproj dosyasındaki değeri değiştirinTargetFramework. İsteğe bağlı olsa da, staticwebapp.config.json dosyasında bir apiRuntime değer ayarlarsanız, değerin csproj dosyasında tanımladığınız değerle eşleştiğinden emin olun.

Aşağıdaki örnekte, CSproj dosyasında API dili çalışma zamanı sürümü olarak NET 8.0 öğesinin nasıl güncelleştirildiği TargetFramework gösterilmektedir.

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

Node.js

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

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

Python

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

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

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

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

[! NOT] 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ırılan özellikler

Not

Azure İşlevleri v3 kullanımdan kaldırıldığına göre, Static Web Apps Python 3.8 için API çalışma zamanı desteği için Azure İşlevleri v4 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

Aracılığıyla paylaş