Compartir vía

Actualización de las aplicaciones existentes para Unified API

  • Artículo

Importante

Classic API de Xamarin, la API anterior a Unified API, ha quedado en desuso.

  • La última versión de Xamarin.iOS que admitía Classic API (monotouch.dll) era Xamarin.iOS 9.10.
  • Xamarin.Mac todavía admite Classic API, pero ya no se actualiza. Dado que está en desuso, los desarrolladores deben mover sus aplicaciones a Unified API.

Actualización de las aplicaciones

Hay tres pasos para actualizar las aplicaciones:

  1. Corrija las advertencias del compilador en el código existente, especialmente las relacionadas con las API en desuso.

  2. Use la herramienta de migración integrada en Visual Studio para Mac para actualizar los archivos de proyecto y los espacios de nombres.

  3. Corrija los errores restantes del compilador relacionados con los nuevos tipos de 64 bits y otras API que han cambiado. Consulte estas sugerencias para obtener información adicional sobre las actualizaciones manuales que podrían ser necesarias.

Hay guías específicas disponibles para cada producto que le ayudarán a actualizar las aplicaciones para Unified API y para obtener compatibilidad con los tipos de 64 bits:

Aplicaciones de Xamarin.iOS

Las aplicaciones existentes de Xamarin.iOS se pueden actualizar para Unified API mediante la herramienta de migración automática integrada en Visual Studio para Mac. Es posible que se requieran algunas correcciones adicionales, como se explica en estas instrucciones y sugerencias.

Aplicaciones de Xamarin.Mac

Las aplicaciones existentes de Xamarin.Mac se pueden actualizar para Unified API mediante la herramienta de migración automática integrada en Visual Studio para Mac. Es posible que se requieran algunas correcciones adicionales, como se explica en estas instrucciones y sugerencias.

Aplicaciones de Xamarin.Forms

Siga estas instrucciones para actualizar una solución de Xamarin.Forms existente con un proyecto de iOS para usar Unified API. La compatibilidad con Unified API solo está disponible en Xamarin.Forms 1.3 y versiones posteriores, por lo que las instrucciones también explican cómo actualizar la aplicación de Xamarin.Forms a la versión 1.3. Estas sugerencias pueden ayudar a actualizar cualquier código nativo de iOS en representadores personalizados o servicios de dependencia.

Trabajo con tipos nativos en aplicaciones multiplataforma

En este artículo se describe el uso de los nuevos tipos nativos de Unified API para iOS (nint, nuint y nfloat) en una aplicación multiplataforma en la que el código se comparte con dispositivos que no son iOS, como sistemas operativos Android o Windows Phone. Proporciona información sobre cuándo se deben usar los tipos nativos y proporciona varias soluciones posibles a los casos en los que el nuevo tipo debe usarse con código multiplataforma.

Actualización de enlaces para Unified API

Los clientes que han creado enlaces a bibliotecas de Objective-C deberán actualizar el proyecto de enlace para reflejar los cambios en la API subyacente (donde algunos tipos ahora serán de 64 bits). Siga estas instrucciones para actualizar un proyecto de enlace existente para hacerlo compatible con Unified API.