Compare versões de runtime do Funções do Azure

Atualmente, o Funções do Azure suporta duas versões do host em tempo de execução. A tabela seguinte detalha as versões de runtime atualmente suportadas, o seu nível de suporte e quando as deve usar:

^* O suporte termina a 14 de setembro de 2026. Para mais informações, consulte o anúncio de suporte à versão 1.x.

O Funções do Azure atualmente suporta apenas a versão 4.x do host de runtime.

A tabela seguinte mostra as versões .NET suportadas pelo Funções do Azure.

A versão suportada do .NET depende tanto da versão de runtime das Funções como do modelo de execução selecionado.

A tabela seguinte mostra as versões da linguagem suportadas para aplicações de funções Java:

^*A data de fim de suporte para o Java 25 é determinada quando é declarada a disponibilidade geral (GA).

Para mais informações sobre o desenvolvimento e execução de aplicações Java funções, consulte Funções do Azure Java developer guide.

A tabela a seguir mostra as versões de idioma suportadas para aplicativos de função Node.js:

TypeScript é suportado através de transpilação para JavaScript. Para mais informações, consulte Funções do Azure Node.js guia para desenvolvedores.

A tabela a seguir mostra a versão de idioma com suporte para aplicativos de função do PowerShell:

Para mais informações, consulte Funções do Azure PowerShell developer guide.

A tabela seguinte mostra as versões da linguagem suportadas para aplicações de funções Python:

¹ A data de fim de apoio para Python 3.14 é determinada quando é declarada disponibilidade geral (GA). ² O suporte remoto para compilações Python 3.14 ainda não está disponível quando se executa num plano Flex Consumption.

Para mais informações, consulte Funções do Azure Python guia para desenvolvedores.

Alterar a versão das aplicações no Azure

Os seguintes valores principais de versão de tempo de execução são usados:

Tecnicamente, não há uma correlação entre as versões das extensões de vinculação e a versão de tempo de execução do Functions. No entanto, a partir da versão 4.x, o runtime das Funções impõe uma versão mínima para todas as extensões de trigger e binding.

Se você receber um aviso sobre um pacote que não atende a uma versão mínima necessária, atualize esse pacote NuGet para a versão mínima como faria normalmente. Encontre os requisitos mínimos de versão para extensões usadas nas Funções v4.x em o ficheiro de configuração ligado.

Para o script C#, atualize a referência do bundle de extensões no host.json:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Tecnicamente, não há uma correlação entre as versões do pacote de extensão e a versão de tempo de execução do Functions. No entanto, a partir da versão 4.x, o runtime de Funções impõe uma versão mínima para pacotes de extensão.

Se você receber um aviso sobre sua versão do pacote de extensão não atender a uma versão mínima necessária, atualize sua referência de pacote de extensão existente no host.json da seguinte maneira:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Para saber mais sobre pacotes de extensão, consulte Pacotes de extensão.

Versões de aplicativos desenvolvidas localmente

Faça as seguintes atualizações nas aplicações funcionais para alterar localmente as versões alvo.

Versões de runtime do Visual Studio

No Visual Studio, selecionas a versão em tempo de execução quando crias um projeto. As ferramentas Funções do Azure para Visual Studio suportam as duas principais versões de runtime. A versão correta é usada durante a depuração e publicação com base nas configurações do projeto. As configurações de versão são definidas no arquivo .csproj nas seguintes propriedades:

<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>

<TargetFramework>net48</TargetFramework>
<AzureFunctionsVersion>v1</AzureFunctionsVersion>

Visual Studio Code e Funções do Azure Core Tools

Funções do Azure Core Tools é usado para desenvolvimento de linha de comandos e também pela extensão Funções do Azure para Visual Studio Code. Para mais informações, consulte Install the Funções do Azure Core Tools.

Para o desenvolvimento no Visual Studio Code, pode ser necessário também atualizar as configurações do utilizador para o azureFunctions.projectRuntime para corresponder à versão das ferramentas instaladas. Essa configuração também atualiza os modelos e idiomas usados durante a criação do aplicativo de função.