Comparar versões de tempo de execução do Azure Functions

Azure Functions atualmente dá suporte a duas versões do host de runtime. A tabela a seguir detalha as versões de runtime com suporte no momento, seu nível de suporte e quando usá-las:

^* O suporte termina em 14 de setembro de 2026. Para obter mais informações, consulte o comunicado de suporte da versão 1.x.

Azure Functions atualmente dá suporte apenas à versão 4.x do host de runtime.

A tabela a seguir mostra as versões .NET compatíveis com Azure Functions.

A versão com suporte do .NET depende da versão do runtime do Functions e do modelo de execução selecionado.

A tabela a seguir mostra as versões de idioma com suporte para aplicativos de funções Java:

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

Para obter mais informações sobre como desenvolver e executar aplicativos de funções Java, consulte Azure Functions Java guia do desenvolvedor.

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

TypeScript tem suporte por meio de transposição para JavaScript. Para obter mais informações, consulte Azure Functions Node.js guia do desenvolvedor.

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

Para obter mais informações, consulte Azure Functions guia do desenvolvedor do PowerShell.

A tabela a seguir mostra as versões de idioma com suporte para aplicativos de funções Python:

¹ A data de fim do suporte para Python 3.14 é determinada quando a GA (disponibilidade geral) é declarada. ² O suporte de build remoto para Python 3.14 ainda não se encontra disponível quando executado em um plano de Consumo Flexível.

Para obter mais informações, consulte Azure Functions Python guia do desenvolvedor.

Alterar a versão dos aplicativos no Azure

Os seguintes valores de versão de runtime principal são usados:

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

Se receber um aviso sobre um pacote não atender a uma versão mínima necessária, você deverá atualizar esse pacote NuGet para a versão mínima como faria normalmente. Encontre os requisitos mínimos de versão para extensões usadas no Functions v4.x em o arquivo de configuração vinculado.

Para script C#, atualize a referência do pacote de extensão 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 de extensão de pacote e a versão de runtime do Functions. No entanto, a partir da versão 4.x, o runtime do Functions impõe uma versão mínima para pacotes de extensão.

Se você receber um aviso sobre a 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 do aplicativo desenvolvidas localmente

Faça as seguintes atualizações nos aplicativos de funções para alterar localmente as versões de destino.

Versões de runtime do Visual Studio

Em Visual Studio, você seleciona a versão de runtime ao criar um projeto. As ferramentas do Azure Functions para Visual Studio suportam as duas principais versões de tempo de execução. A versão correta é usada ao depurar e publicar 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>

ferramentas principais Visual Studio Code e Azure Functions

Azure Functions Core Tools é usado para desenvolvimento de linha de comando e também pela extensão Azure Functions para Visual Studio Code. Para obter mais informações, consulte Instale o Azure Functions Core Tools.

Para o desenvolvimento no Visual Studio Code, talvez você também precise ajustar a configuração do usuário do azureFunctions.projectRuntime para corresponder à versão das ferramentas instaladas. Essa configuração também atualiza os modelos e linguagens utilizados durante a criação do aplicativo de funções.