Idiomas e tempos de execução suportados nos Aplicativos Web Estáticos do Azure

Os Aplicativos Web Estáticos do Azure apresentam dois locais diferentes onde as versões de tempo de execução e idioma são importantes, no front-end e para a API.

Front-end

Você pode especificar a versão usada para criar o front-end do seu aplicativo Web estático. A configuração de uma versão não padrão geralmente só é necessária se você precisar direcionar versões mais antigas.

Você pode especificar a versão de tempo de execução que cria o front-end do seu aplicativo Web estático no arquivo package.json na engines seção do arquivo.

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

API

O suporte subjacente para APIs nos Aplicativos Web Estáticos do Azure é fornecido pelo Funções do Azure. Consulte os idiomas e tempos de execução suportados do Funções do Azure para obter detalhes.

As versões a seguir são suportadas para funções gerenciadas em aplicativos Web estáticos. Se o seu aplicativo exigir uma versão não listada, considere trazer suas próprias funções para seu aplicativo.

Para configurar a versão de tempo de execução da linguagem da API, defina a propriedade na secção apiRuntime para um dos seguintes valores suportados.

.NET

Para alterar a versão do runtime numa aplicação .NET, altere o TargetFramework valor no ficheiro csproj e defina o apiRuntime valor no ficheiro staticwebapp.config.json para a versão correspondente. Certifica-te de que o valor apiRuntime corresponde ao que defines no ficheiro csproj.

.NET 10.0 é suportado apenas com o modelo de processo de trabalho isolado. Se a sua API usar o modelo em processo, migre primeiro para o modelo de processo de trabalho isolado. Para os pacotes e definições de projeto necessários para direcionar o .NET 10.0, consulte Guia para executar C# Funções do Azure no modelo de trabalhador isolado.

O exemplo seguinte demonstra como atualizar o elemento TargetFramework para .NET 10.0 como a versão do runtime da linguagem da API no ficheiro csproj.

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

A configuração de exemplo seguinte demonstra como usar a propriedade apiRuntime para selecionar .NET 10.0 isolado como a versão de runtime da linguagem da API no ficheiro staticwebapp.config.json.

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

Node.js

O exemplo de configuração a seguir demonstra como usar a propriedade apiRuntime para selecionar Node.js 20 como a versão de runtime da linguagem da API no arquivo staticwebapp.config.json.

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

Python

O exemplo de configuração a seguir demonstra como usar a apiRuntime propriedade para selecionar Python 3.11 como a versão de tempo de execução da linguagem API no arquivo staticwebapp.config.json .

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

Reativando proxies na v4.x

O Funções do Azure dá suporte à reativação de proxies na v4.x. Para habilitar o suporte a proxy em funções gerenciadas para seu aplicativo Web estático, defina SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS como true nas configurações do aplicativo.

Deprecações

Os seguintes tempos de execução foram preteridos nos Aplicativos Web Estáticos do Azure. Para obter mais informações sobre como alterar seu tempo de execução, consulte Especificar a versão do tempo de execução da linguagem da API nos Aplicativos Web Estáticos do Azure e Migrar aplicativos do Funções do Azure versão 3.x para a versão 4.x.

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