Actualización de proyectos de Xamarin.Android, Xamarin.iOS y Xamarin.Mac a .NET

Para actualizar los proyectos nativos de Xamarin a .NET, debes hacer lo siguiente:

Para la mayoría de los proyectos, no tendrá que cambiar los espacios de nombres ni realizar otras reescrituras.

Para simplificar el proceso de actualización, se recomienda crear un nuevo proyecto de .NET con el mismo tipo y nombre que el proyecto nativo de Xamarin y, a continuación, copiar en el código. Este es el método que se describe a continuación.

Cree un nuevo proyecto

En Visual Studio, crea un nuevo proyecto de .NET del mismo tipo y nombre que el proyecto nativo de Xamarin. Por ejemplo, para actualizar de Xamarin.Android a .NET para Android, seleccione la plantilla de proyecto Aplicación Android:

El nuevo proyecto debe tener el mismo nombre de proyecto y paquete que el proyecto existente y debe colocarse en una nueva carpeta. Al abrir el archivo del proyecto, se confirmará que tienes un proyecto de estilo SDK de .NET:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-android</TargetFramework>
    <SupportedOSPlatformVersion>21</SupportedOSPlatformVersion>
    <OutputType>Exe</OutputType>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <ApplicationId>com.companyname.AndroidApp2</ApplicationId>
    <ApplicationVersion>1</ApplicationVersion>
    <ApplicationDisplayVersion>1.0</ApplicationDisplayVersion>
  </PropertyGroup>
</Project>

Inicia la aplicación para confirmar que tu entorno de desarrollo puede compilar la aplicación.

Combinación de archivos

Copie el código y los archivos de recursos de las carpetas del proyecto nativo de Xamarin en carpetas idénticas dentro de la nueva aplicación. Debes sobrescribir cualquier archivo del mismo nombre.

Si tienes otros proyectos de biblioteca, debes agregarlos a tu nueva solución y agregar referencias de proyecto a ellos desde el nuevo proyecto de .NET.

También tendrás que copiar algunas propiedades del proyecto de tu proyecto nativo de Xamarin en tu nuevo proyecto de .NET para la configuración, como argumentos de compilación condicional y firma de código. Abrir los proyectos en paralelo en instancias independientes de Visual Studio te permitirá comparar las propiedades del proyecto. Como alternativa, puedes migrar la configuración editando el nuevo archivo de proyecto directamente. Para obtener más información, consulta Migración de proyectos de Xamarin.Android y Migración de proyectos de Xamarin Apple.

Actualización de las dependencias

Por lo general, los paquetes NuGet nativos de Xamarin no son compatibles con .NET 8 a menos que se hayan vuelto a compilar mediante TFM de .NET. Sin embargo, las aplicaciones de .NET para Android pueden usar paquetes NuGet destinados a los marcos monoandroid y monoandroidXX.X .

Para confirmar que un paquete es compatible con .NET 8, examina la pestaña Marcos de NuGet para el paquete que usa y comprueba que enumera uno de los marcos compatibles que se muestran en la tabla siguiente:

Si un paquete de NuGet indica compatibilidad con cualquiera de los marcos compatibles anteriores, independientemente de incluir también marcos incompatibles, el paquete es compatible. Los paquetes NuGet compatibles se pueden agregar a tu proyecto nativo de .NET mediante el administrador de paquetes NuGet en Visual Studio.

Si no encuentras una versión compatible con .NET 8 de un paquete NuGet, debes:

• Vuelve a compilar el paquete con TFM de .NET, si posees el código.
• Busca una versión preliminar de una versión de una versión de .NET 8 del paquete.
• Reemplaza la dependencia por una alternativa compatible con .NET 8.

Para obtener información sobre cómo migrar código de Xamarin.Essentials en una aplicación .NET para Android o .NET para iOS, consulte Migración de código de Xamarin.Essentials en .NET para Android y .NET para aplicaciones iOS.

Compilación y solución de problemas

Una vez resueltas tus dependencias y agregados tus archivos de código y recursos a tu proyecto de .NET nativo, debes compilar tu proyecto. Los errores te guiarán hacia los pasos siguientes.