Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

Cómo migrar a AndroidX

AndroidX reemplaza las API de la biblioteca de compatibilidad original con paquetes en el espacio de nombres de androidx. Sin embargo, solo cambiaron los nombres de los paquetes y los artefactos Maven; se mantuvieron los nombres de clases, métodos y campos.

Requisitos previos

Antes de realizar la migración, actualiza tu app. Te recomendamos actualizar tu proyecto para usar la versión final de la biblioteca de compatibilidad: versión 28.0.0. El motivo es que los artefactos de AndroidX con la versión 1.0.0 son equivalentes binarios a los artefactos de la biblioteca de compatibilidad 28.0.0.

Cómo migrar un proyecto existente con Android Studio

Con Android Studio 3.2, puedes migrar rápidamente un proyecto existente para usar AndroidX si seleccionas Refactor > Migrate to AndroidX en la barra de menú.

El comando de refactorización utiliza dos marcas. De forma predeterminada, ambas están configuradas en true en tu archivo gradle.properties.

android.useAndroidX=true
El complemento de Android utiliza la biblioteca de AndroidX adecuada en lugar de una biblioteca de compatibilidad.
android.enableJetifier=true
El complemento de Android migra automáticamente las bibliotecas de terceros existentes a AndroidX. Para ello, reescribe sus objetos binarios.

Asignaciones

Si tienes problemas con la migración, consulta estas tablas a fin de determinar las asignaciones correctas de la biblioteca de compatibilidad para los artefactos y clases de AndroidX correspondientes:

Para obtener las versiones más recientes de las bibliotecas de Jetpack, consulta la página de versiones.

Recursos adicionales

Para obtener más información sobre cómo migrar tu código a AndroidX, consulta los siguientes recursos adicionales:

Entradas de blog (en inglés)