O que é o .NET Upgrade Assistant?
O Assistente de Atualização do .NET ajuda a atualizar projetos para versões mais recentes do .NET e analisa seu código para detetar e corrigir possíveis incompatibilidades. Um foco da ferramenta é ajudar a migrar um projeto do .NET Framework, .NET Core ou .NET, para a versão mais recente do .NET. Você usa a extensão ou ferramenta para atualizar projetos .NET inteiros, ou algum aspeto do projeto, como migrar um arquivo de configuração de um tipo mais antigo para um tipo mais recente.
O Assistente de Atualização do .NET é distribuído como uma extensão do Visual Studio ou uma ferramenta de interface de linha de comando (CLI).
Analise e atualize
O .NET Upgrade Assistant inclui um mecanismo de análise que verifica seus projetos e suas dependências. Após a conclusão da verificação, um relatório é gerado com informações detalhadas sobre como executar uma atualização. Você pode usar essas informações para atualizar todo o projeto ou partes específicas do projeto.
Tipos de projetos suportados
O .NET Upgrade Assistant oferece suporte à atualização de projetos codificados em C# ou Visual Basic. São apoiados os seguintes tipos de projetos:
- ASP.NET
- Funções do Azure
- Windows Presentation Foundation
- Windows Forms
- Bibliotecas de classes
- Aplicações de consola
- Formulários Xamarin
- .NET MAUI
- UWP nativa do .NET
Alguns produtos fornecem orientação sobre como usar o Assistente de Atualização do .NET.
- ASP.NET
- Windows Presentation Foundation
- Formulários do Windows
- Plataforma Universal do Windows
- Windows Communication Foundation
Caminhos de atualização
Os seguintes caminhos de atualização são suportados:
- .NET Framework para .NET
- .NET Core para .NET
- Azure Functions v1-v3 a v4 isolado (visando net6.0+)
- UWP para WinUI 3
- Versão anterior do .NET para a versão mais recente do .NET
- Formulários Xamarin para .NET MAUI
- As transformações de arquivo XAML suportam apenas a atualização de namespaces. Para transformações mais abrangentes, use o Visual Studio 2022 versão 17.6 ou posterior.
Detalhes e opções de atualização
Quando uma atualização é iniciada, um assistente orienta você na configuração de algumas das opções antes que a atualização seja iniciada. Com base no tipo de projeto que você está atualizando, o assistente apresenta diferentes opções. Para obter um exemplo de atualização de um projeto, consulte Atualizar projetos com o Assistente de Atualização do .NET.
Como a atualização deve ser executada
Com base no tipo de projeto que você está atualizando, talvez seja possível alterar a forma como a atualização é executada. O tipo de projeto afeta quais opções estão disponíveis, e um ou mais dos seguintes itens podem estar faltando:
Atualização de projeto in-loco
Esta opção atualiza seu projeto sem fazer uma cópia.
Atualização do projeto lado a lado
Copia seu projeto e atualiza a cópia, deixando seu projeto original sozinho.
Incremental lado a lado
Esta é uma boa escolha para aplicações Web complicadas. A atualização do ASP.NET para o ASP.NET Core requer bastante trabalho e, às vezes, refatoração manual. Este modo coloca um projeto .NET ao lado do projeto .NET Framework existente. Os pontos de extremidade são roteados através do projeto .NET, enquanto todas as outras chamadas são enviadas para o aplicativo .NET Framework.
Este modo permite-lhe atualizar lentamente a sua aplicação de ASP.NET ou biblioteca peça por peça.
Resultados da atualização
Quando a atualização for concluída, uma tela de status será exibida mostrando todos os artefatos associados à atualização. Cada artefato de atualização pode ser expandido para ler mais informações sobre o status. A lista a seguir descreve os ícones de status:
- Marca de verificação verde não preenchida: a ferramenta não encontrou nada sobre o artefato a ser atualizado.
- Marca de verificação verde preenchida: O artefato foi atualizado e concluído com êxito.
- Sinal de aviso amarelo: O artefato foi atualizado, mas há informações importantes que você deve considerar.
- Red X: A atualização do artefato não foi bem-sucedida.
Além disso, as ações executadas durante a atualização são registradas na janela Saída na fonte do Assistente de Atualização , conforme mostrado na imagem a seguir:
Depois de atualizar seu projeto, teste-o completamente!
