Share via

Actualización de una aplicación Xamarin.Forms a una aplicación .NET MAUI con .NET Upgrade Assistant

  • Artículo

.NET Upgrade Assistant te ayuda a actualizar proyectos Xamarin.Forms a .NET Multi-platform App UI (.NET MAUI) convirtiendo el archivo del proyecto de la solución y realizando actualizaciones de código comunes. En concreto, la herramienta hará lo siguiente:

  • Convertir el proyecto de biblioteca de clases Xamarin.Forms, el proyecto de Xamarin.iOS y el proyecto de Xamarin.Android en proyectos de estilo SDK.
  • Actualizar la plataforma de destino en los archivos de proyecto a net8.0-android y net8.0-ios, según sea necesario.
  • Establecer <UseMaui>true</UseMaui> en los archivos del proyecto.
  • Agregar propiedades del proyecto adicionales y quitar las propiedades del proyecto que no son necesarias.
  • Agregar y quitar paquetes NuGet específicos:
    • Quitar los paquetes NuGet Xamarin.Forms y Xamarin.Essentials.
    • Reemplazar el paquete NuGet Xamarin.CommunityToolkit por el paquete NuGet .NET MAUI Community Toolkit.
    • Reemplazar las versiones compatibles con Xamarin.Forms de los paquetes NuGet SkiaSharp por versiones compatibles con .NET MAUI, si se usan.
  • Quitar las referencias al espacio de nombres Xamarin.Essentials y reemplazar el espacio de nombres Xamarin.Forms por los espacios de nombres Microsoft.Maui y Microsoft.Maui.Controls.

Después de ejecutar la herramienta, la aplicación necesitará trabajo adicional para completar la migración.

Nota:

.NET Upgrade Assistant para .NET MAUI no admite la actualización de proyectos de UWP, proyectos de extensión de iOS ni proyectos de enlace.

Para ver más información sobre .NET Upgrade Assistant, incluidos los otros tipos de aplicaciones que puede convertir, consulta Información general sobre el Asistente para actualización de .NET.

Introducción

.NET Upgrade Assistant está disponible como una extensión de Visual Studio en Windows y como herramienta de la CLI para Windows y Mac. Para usarlo, el proyecto Xamarin.Forms debe usar la versión 4.8 o posterior de Xamarin.Forms. Sin embargo, para conseguir el mejor éxito, se recomienda que el proyecto Xamarin.Forms use Xamarin.Forms 5.0 y .NET Standard 2.0 o superior.

Importante

.NET Upgrade Assistant para .NET MAUI todavía está en desarrollo. Envía tus comentarios con una etiqueta 'area:Maui' para que podamos seguir mejorando esta herramienta.

.NET Upgrade Assistant te preguntará el tipo de actualización que quieres realizar:

  • In-place:esta opción actualiza el proyecto sin realizar una copia.
  • Side-by-side: esta opción copia el proyecto y actualiza la copia, dejando al proyecto original solo. Actualmente, una actualización en paralelo de .NET MAUI requiere la creación de nuevos proyectos para actualizar cada título de proyecto. Si intentas actualizar un título de proyecto a un proyecto existente, es probable que se produzcan errores y que no sea una experiencia admitida en este momento.

Antes de actualizar la aplicación Xamarin.Forms a .NET MAUI, primero debes actualizar la aplicación Xamarin.Forms para usar Xamarin.Forms 5 y asegurarte de que todavía se ejecuta correctamente. Además, debes actualizar las dependencias que usa la aplicación a las versiones más recientes.

Esto ayudará a simplificar el resto del proceso de migración, ya que minimizará las diferencias de API entre Xamarin.Forms y .NET MAUI y garantizará que estás usando versiones compatibles con .NET de las dependencias si existen.

Acciones rápidas en Visual Studio

El Asistente para actualización de .NET tiene una acción rápida para convertir Xamarin.Forms espacios de nombres en los espacios de nombres .NET MAUI adecuados, que se muestran como una bombilla:

Screenshot of previewing the application of a light bulb suggestion.

La acción rápida realizará los reemplazos necesarios en el archivo.

Nota:

Las bombillas de acción rápida aparecerán a medida que migre los archivos del Xamarin.Forms proyecto a un proyecto maui de .NET.

Instalación

Se recomienda Visual Studio 2022 versión 17.6.0 o posterior para ejecutar el asistente para actualización. Para instalar la extensión del asistente para actualización:

  1. Abre Visual Studio y selecciona el elemento de menú Extensiones > Administrar extensiones.
  2. En el cuadro de diálogo Administrar extensiones, busca y descarga .NET Upgrade Assistant.
  3. Una vez descargada la extensión, cierre Visual Studio. La extensión se instalará.

Las extensiones se actualizan de forma automática cuando hay una versión nueva disponible en Visual Studio Marketplace. Para obtener más información, consulta Actualizaciones automáticas de extensiones.

Ejecución del asistente para actualización

Desde el Explorador de soluciones, haz clic con el botón derecho en el proyecto y selecciona Actualizar.

Pasos siguientes

Migración manual