Cómo migrar a AndroidX

AndroidX reemplaza las API de la biblioteca de compatibilidad original con paquetes en el espacio de nombres de androidx. 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 y versiones posteriores, 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 para Android usa la biblioteca de AndroidX adecuada en lugar de una biblioteca de compatibilidad.
android.enableJetifier=true
El complemento para Android migra automáticamente las bibliotecas existentes de terceros a AndroidX y, por eso, reescribe sus objetos binarios.

Asignaciones

Si tienes problemas con la migración, consulta estas tablas y determina las asignaciones correctas de la biblioteca de compatibilidad para los artefactos y las 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

Videos