Ler em inglês

Compartilhar via


Atualizar para uma nova versão do .NET

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 tenha mais suporte. Há vários aspectos que devem ser considerados no processo de atualização.

Motivos comuns para atualizar para uma nova versão do .NET:

  • Não há mais suporte para a versão do .NET usada no momento
  • A nova versão dá suporte a um novo sistema operacional
  • A nova versão tem um recurso importante de API, desempenho ou segurança

Atualizar 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 versão da CLI do .NET atualizada, do sistema de build e do runtime.

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

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 propriedade TargetFramework em um arquivo de projeto para a versão mais recente do .NET.

Veja como fazer isso:

  • Abra o arquivo de projeto (o arquivo *.csproj, *.vbproj ou *.fsproj).
  • Altere o valor da propriedade <TargetFramework> de, por exemplo, net6.0 para net8.0.
  • O mesmo padrão se aplica à propriedade <TargetFrameworks> 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 CI (integração contínua)

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

Atualizar o ambiente de hospedagem

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

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

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

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

Em um serviço de nuvem como o Serviço de Aplicativo do Azure, é necessário alterar a configuração.