AndroidX con Xamarin

Introducción al desarrollo de aplicaciones con AndroidX mediante Xamarin.Android.

AndroidX supone una mejora importante en la biblioteca de compatibilidad de Android original, que ya no se mantiene. Los paquetes de AndroidX reemplazan por completo a la biblioteca de compatibilidad de Android proporcionando una paridad de características y nuevas bibliotecas que se pueden usar en las aplicaciones de Android.

Android incluye las siguientes características:

  • Todos los paquetes dentro de AndroidX tienen ahora un espacio de nombres coherente que empieza por androidx. Esto significa que todos los paquetes de la biblioteca de compatibilidad de Android se asignan a un paquete de androidx.* correspondiente.
  • Los paquetes de androidx se mantienen y actualizan por separado. Esto significa que puede actualizar las bibliotecas de AndroidX de forma independiente entre sí.
  • A partir de la v28 de la biblioteca de compatibilidad de Android, no habrá más versiones. A partir de entonces, todo el desarrollo se incluirá en androidx.

AndroidX Logo

Requisitos

Para usar las características de AndroidX en aplicaciones basadas en Xamarin, se requiere lo siguiente:

  • Visual Studio: en Windows, actualice a Visual Studio 2019 versión 16.4 o posterior. En macOS, actualice a Visual Studio 2019 para Mac versión 8.4 o posterior.
  • Xamarin.Android: Xamarin.Android 10.0 o posterior debe instalarse con Visual Studio (Xamarin.Android se instala automáticamente como parte de la carga de trabajo de desarrollo móvil con .NET en Windows y se instala como parte del instalador de Visual Studio para Mac).
  • Kit para desarrolladores de Java: el desarrollo de Xamarin.Android 10.0 requiere JDK 8. La distribución de Microsoft de OpenJDK se instala automáticamente como parte de Visual Studio.
  • Android SDK: la API 28 o superior de Android SDK debe estar instalada con el Administrador de Android SDK.

Introducción

Puede empezar a trabajar con AndroidX incluyendo cualquier paquete de NuGet de AndroidX dentro del proyecto de Android. Obtenga más información sobre cómo instalar y usar un paquete en Visual Studio o Visual Studio para Mac

Cambios de comportamiento

Dado que AndroidX es un nuevo diseño de la biblioteca de compatibilidad de Android, incluye pasos de migración que afectarán a las aplicaciones Android compiladas con la biblioteca de compatibilidad de Android.

Cambio de nombre de paquete

Los nombres de paquete se han cambiado entre los paquetes antiguo y nuevo. A continuación puede ver un ejemplo de estos cambios:

Antiguo Nuevo
android.support.** androidx.@
android.design.** com.google.android.material.@
android.support.test.** androidx.test.@
android.arch.** androidx.@
android.arch.persistence.room.** androidx.room.@
android.arch.persistence.** androidx.sqlite.@

Para obtener más información sobre la nomenclatura de paquetes, consulte la siguiente documentación.

Herramientas de migración

Hay tres pasos de migración que se deben tener en cuenta para la aplicación.

  1. Si la aplicación incluye espacios de nombres de la biblioteca de compatibilidad de Android y desea migrarlos a los espacios de nombres de AndroidX, puede usar nuestras herramientas del IDE de migración a AndroidX para tratar con la mayoría de los escenarios de espacio de nombres.

Habilite AndroidX Migrator a través de Herramientas > Opciones > Xamarin > Configuración de Android en Visual Studio 2019 (puede omitir este paso en Visual Studio para Mac).

Enable AndroidX Migrator

Haga clic con el botón derecho en el proyecto y seleccione Migrar a AndroidX.

Migrate To AndroidX

Nota:

Tendrá que realizar algunos cambios manuales en el espacio de nombres para los escenarios que la herramienta no abarca. Aunque asignaremos el paquete correcto automáticamente, se recomienda que eche un vistazo a las asignaciones de artefactos y las asignaciones de clases oficiales para ayudar a la migración del proyecto.

  1. Si la aplicación incluye las dependencias que no se han migrado al espacio de nombres de AndroidX, tendrá que usar la biblioteca de compatibilidad de Android con el paquete de migración de AndroidX.
  2. Si la aplicación no incluye ninguna dependencia que requiera la migración del espacio de nombres de AndroidX, puede usar las bibliotecas de AndroidX en NuGet actualmente.

Solución de problemas

  • Algunos paquetes de arquitectura dentro de AndroidX entrarán en conflicto con las versiones de la biblioteca de compatibilidad. Para solucionarlo, debe usar la versión AndroidX de estos paquetes y quitar la versión de la biblioteca de compatibilidad. Por ejemplo, si hace referencia a Xamarin.Android.Arch.Work.Runtime en el proyecto, entrará en conflicto con los tipos del paquete de AndroidX.Work recién agregado.

Resumen

En este artículo se presentó AndroidX y se explicó cómo instalar y configurar las herramientas y los paquetes más recientes para el desarrollo de Xamarin.Android en AndroidX. Proporcionó una visión general de lo que es AndroidX. Incluye vínculos a la documentación de la API y temas para desarrolladores de Android que le ayudarán a empezar a crear aplicaciones con AndroidX. También se resaltan los cambios de comportamiento más importantes de AndroidX y los temas para la solución de problemas que pueden afectar a las aplicaciones existentes.