Partilhar via

Atualizar para uma nova versão do .NET

  • Artigo

Novas versões do .NET são lançadas a cada ano. Muitos desenvolvedores iniciam o processo de atualização assim que a nova versão está disponível, enquanto outros esperam até que a versão que estão usando não seja mais suportada. O processo de atualização tem vários aspetos a considerar.

Razões comuns para atualizar para uma nova versão do .NET:

  • A versão .NET usada atualmente não é mais suportada
  • A nova versão suporta um novo sistema operacional
  • A nova versão tem uma API, desempenho ou recurso de segurança importante

Atualizar o ambiente de desenvolvimento

Para atualizar para uma nova versão do .NET, o SDK do .NET é o componente principal a ser instalado. Ele inclui uma CLI .NET atualizada, sistema de compilação e versão de tempo de execução.

O site .NET oferece instaladores e arquivos que você pode baixar e usar em qualquer sistema operacional e arquitetura suportados.

Alguns sistemas operacionais têm um gerenciador de pacotes que você também pode usar para instalar uma nova versão do .NET, que você pode preferir.

O Visual Studio instala novas versões do SDK do .NET automaticamente. Para usuários do Visual Studio, é suficiente atualizar para uma versão mais recente do Visual Studio.

Atualizar código-fonte

A única alteração necessária para atualizar um aplicativo é atualizar a TargetFramework propriedade em um arquivo de projeto para a versão mais recente do .NET.

Saiba como o fazer a seguir:

  • Abra o arquivo de projeto (o *.csproj, *.vbprojou *.fsproj arquivo).
  • Altere o valor da <TargetFramework> propriedade de, por exemplo, net6.0 para net8.0.
  • O mesmo padrão se aplica à <TargetFrameworks> propriedade se ela estiver sendo usada.

O Assistente de Atualização pode fazer essas alterações automaticamente.

A próxima etapa é criar o projeto (ou solução) com o novo SDK. Se forem necessárias alterações adicionais, o SDK fornecerá avisos e erros que o orientarão.

Talvez seja necessário executar dotnet workload restore para restaurar cargas de trabalho com a nova versão do SDK.

Mais recursos:

Atualizar a integração contínua (CI)

Os pipelines de CI seguem um processo de atualização semelhante aos arquivos de projeto e Dockerfiles. Normalmente, você pode atualizar os pipelines de CI alterando apenas os valores de versão.

Atualizar ambiente de hospedagem

Há muitos padrões que são usados para hospedar aplicativos. Se o ambiente de hospedagem incluir o tempo de execução do .NET, a nova versão do tempo de execução do .NET precisará ser instalada. No Linux, as dependências precisam ser instaladas , no entanto, elas normalmente não mudam nas versões .NET.

Para contêineres, FROM as instruções precisam ser alteradas para incluir novos números de versão.

O exemplo Dockerfile a seguir demonstra a extração de uma imagem do ASP.NET Core 9.0.

FROM mcr.microsoft.com/dotnet/aspnet:9.0

Em um serviço de nuvem como o Serviço de Aplicativo do Azure, uma alteração de configuração é necessária.