Partilhar via


Atualizar do Xamarin para o .NET

Importante

O suporte Microsoft para Xamarin terminará a 1 de maio de 2024 para todos os SDKs Xamarin, incluindo Xamarin.Forms. Ajude-nos a melhorar a sua experiência de atualização de Xamarin para .NET MAUI ao completar este pequeno inquérito.

Os projetos Xamarin podem correr em .NET após completar um processo de atualização. A tabela seguinte lista os tipos de projetos Xamarin que podem ser atualizados para .NET:

Tipo de Projeto Aprimoramento Guide
Xamarin.Android Atualizar projetos nativos Xamarin
Xamarin.iOS Atualizar projetos nativos Xamarin
Xamarin.Mac Atualizar projetos nativos Xamarin
Xamarin.tvOS Atualizar projetos nativos Xamarin
Xamarin.Formulários Atualize uma aplicação Xamarin.Forms para uma aplicação .NET MAUI multi-projeto
Atualize uma aplicação Xamarin.Forms para uma única aplicação .NET MAUI de projeto
Xamarin.Forms UWP Migração do projeto UWP do Xamarin.Forms
Extensões de Aplicações iOS Atualizar projetos nativos Xamarin
Android Wear Atualizar projetos nativos Xamarin
Biblioteca de Encadernação Android Migração do projeto de binding Xamarin.Android
Biblioteca de Encadernação do iOS Migração do projeto de binding Xamarin.iOS
SpriteKit Atualizar projetos nativos Xamarin
SceneKit Atualizar projetos nativos Xamarin
Metal Atualizar projetos nativos Xamarin
OpenGL ❌ (iOS) Removido do iOS porque o OpenTK não está disponível
Xamarin.watchOS Recomendação: incluir extensões Swift com .NET para aplicações iOS

Importante

Para atualizar uma aplicação do Xamarin para .NET:

  • Todos os projetos devem tornar-se no estilo SDK.
  • Os projetos não precisam de ser reescritos.
  • Soluções multi-projeto não precisam de se tornar um único projeto com múltiplos alvos.

Para atualizar os teus projetos nativos Xamarin para .NET, primeiro terás de atualizar os projetos para serem projetos do estilo SDK e depois atualizar as dependências para .NET 8. Para mais informações, consulte Atualizar projetos Xamarin.Android, Xamarin.iOS e Xamarin.Mac para .NET.

O .NET Upgrade Assistant é uma ferramenta de linha de comandos que pode ajudar a atualizar aplicações Xamarin.Forms multi-projetos para aplicações multi-projetos .NET MAUI (App UI Multiplataforma). Depois de executar a ferramenta, na maioria dos casos a aplicação exigirá um esforço adicional para completar a atualização. Para mais informações, consulte Atualizar uma aplicação Xamarin.Forms para uma aplicação .NET MAUI com o Assistente de Atualização .NET.

Também pode atualizar manualmente a aplicação Xamarin.Forms para uma aplicação .NET MAUI com vários projetos através de um processo de dois passos:

  1. Atualize os seus projetos nativos Xamarin, na sua solução Xamarin.Forms, para .NET. Para mais informações, consulte Atualizar as aplicações Xamarin.Android, Xamarin.iOS e Xamarin.Mac para .NET. Além disso, pode atualizar o seu projeto Xamarin.Forms UWP para um projeto .NET MAUI WinUI 3. Para mais informações, consulte migração do projeto UWP do Xamarin.Forms.
  2. Atualize o seu projeto de biblioteca Xamarin.Forms para .NET Multi-platform App UI (.NET MAUI). Para mais informações, consulte Atualizar manualmente uma aplicação Xamarin.Forms para uma aplicação multi-projeto .NET MAUI.

Alternativamente, pode atualizar manualmente uma aplicação Xamarin.Forms para uma aplicação .NET MAUI de projeto único. Para mais informações, consulte Atualizar manualmente uma aplicação Xamarin.Forms para uma única aplicação MAUI .NET de projeto.