Atualizar um aplicativo para um Xamarin.Forms aplicativo .NET MAUI com o Assistente de Atualização do .NET

O Assistente de Atualização do .NET ajuda você a atualizar Xamarin.Forms projetos para a Interface do Usuário do Aplicativo Multiplataforma do .NET (.NET MAUI) convertendo o arquivo de projeto da solução e executando atualizações de código comuns. Especificamente, a ferramenta irá:

  • Converta o projeto de biblioteca de classes, o projeto Xamarin.iOS e o Xamarin.Forms projeto Xamarin.Android em projetos no estilo SDK.
  • Atualize a estrutura de destino nos arquivos de projeto para net8.0-android e net8.0-ios, conforme necessário.
  • Definir <UseMaui>true</UseMaui> em arquivos de projeto.
  • Adicione propriedades de projeto adicionais e remova as propriedades de projeto que não são necessárias.
  • Adicionar e remover pacotes NuGet específicos:
    • Remova os Xamarin.Forms pacotes e Xamarin.Essentials NuGet.
    • Substitua o Xamarin.CommunityToolkit pacote NuGet pelo .NET MAUI Community Toolkit pacote NuGet.
    • Substitua Xamarin.Forms versões SkiaSharp compatíveis dos pacotes NuGet por versões compatíveis com .NET MAUI, se usadas.
  • Remova referências Xamarin.Essentials ao namespace e substitua o Xamarin.Forms namespace por Microsoft.Maui namespaces e Microsoft.Maui.Controls .

Depois de executar a ferramenta, será necessário um esforço adicional para concluir a migração.

Observação

O Assistente de Atualização do .NET para .NET MAUI não oferece suporte à atualização de projetos UWP, projetos de extensão do iOS ou projetos de vinculação.

Para obter mais informações sobre o Assistente de Atualização do .NET, incluindo os outros tipos de aplicativo que ele pode converter, consulte Visão geral do Assistente de Atualização do .NET.

Introdução

O Assistente de Atualização do .NET está disponível como uma extensão do Visual Studio no Windows e como uma ferramenta da CLI para Windows e Mac. Para usá-lo, seu Xamarin.Forms projeto deve usar Xamarin.Forms 4.8 ou superior. No entanto, para obter o melhor sucesso, recomendamos que seu Xamarin.Forms projeto use Xamarin.Forms 5.0 e .NET Standard 2.0 ou superior.

Importante

O Assistente de Atualização do .NET para .NET MAUI ainda está em desenvolvimento. Por favor, registre comentários com um rótulo 'area:Maui' para que possamos continuar a melhorar esta ferramenta.

O Assistente de Atualização do .NET solicitará o tipo de atualização a ser executado:

  • In-loco: essa opção atualiza seu projeto sem fazer uma cópia.
  • Lado a lado: Esta opção copia seu projeto e atualiza a cópia, deixando o projeto original sozinho. Atualmente, uma atualização lado a lado do .NET MAUI requer a criação de novos projetos para atualizar cada chefe de projeto. Tentar atualizar um cabeçalho de projeto em um projeto existente provavelmente causará erros e não é uma experiência com suporte no momento.

Antes de atualizar seu Xamarin.Forms aplicativo para o .NET MAUI, você deve primeiro atualizá-lo Xamarin.Forms para usar Xamarin.Forms 5 e garantir que ele ainda seja executado corretamente. Além disso, você deve atualizar as dependências que seu aplicativo usa para as versões mais recentes.

Isso ajudará a simplificar o restante do processo de migração, pois minimizará as diferenças de API entre Xamarin.Forms o .NET MAUI e garantirá que você esteja usando versões compatíveis com .NET de suas dependências, se elas existirem.

Ações rápidas no Visual Studio

O Assistente de Atualização do .NET tem uma ação rápida para converter Xamarin.Forms namespaces em namespaces .NET MAUI apropriados, que é exibida como uma lâmpada:

Screenshot of previewing the application of a light bulb suggestion.

A ação rápida fará as substituições necessárias em todo o arquivo.

Observação

As lâmpadas de ação rápida aparecerão à medida que você migrar os arquivos do seu Xamarin.Forms projeto para um projeto .NET MAUI.

Instalação

Visual Studio 2022 versão 17.6.0 ou posterior é altamente recomendável para executar o assistente de atualização. Para instalar a extensão do assistente de atualização:

  1. Abra o Visual Studio e selecione o item de menu Extensões Gerenciar Extensões>.
  2. Na caixa de diálogo Gerenciar Extensões, procure e baixe o Assistente de Atualização do .NET.
  3. Depois que a extensão tiver sido baixada, feche o Visual Studio. A extensão será então instalada.

As extensões são atualizadas automaticamente quando uma nova versão está disponível no Visual Studio Marketplace. Para obter mais informações, consulte Atualizações automáticas de extensão.

Executar o assistente de atualização

Clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Atualizar.

Próximas etapas