Como migrar para o AndroidX

O AndroidX substitui as APIs da Biblioteca de Suporte original por pacotes no namespace androidx. Apenas o pacote e os nomes de artefatos Maven foram alterados. Os nomes de classes, métodos e campos permanecem os mesmos.

Pré-requisitos

Antes de fazer a migração, atualize seu app. Recomendamos que você atualize o projeto para usar a versão final da Biblioteca de Suporte: versão 28.0.0. Isso porque os artefatos do AndroidX na versão 1.0.0 são equivalentes binários aos artefatos da Biblioteca de Suporte 28.0.0.

Migrar um projeto existente usando o Android Studio

Com o Android Studio 3.2 e versões posteriores, é possível migrar um projeto existente para o AndroidX selecionando Refactor > Migrate to AndroidX na barra de menu.

O comando "refactor" uso dois sinalizadores. Por padrão, ambos são definidos como true no arquivo gradle.properties:

android.useAndroidX=true
O plug-in do Android usa a biblioteca adequada do AndroidX em vez de uma Biblioteca de Suporte.
android.enableJetifier=true
O plug-in do Android migra automaticamente as bibliotecas de terceiros existentes para o AndroidX reescrevendo os binários delas.

Mapeamentos

Se você encontrar problemas durante a migração, consulte estas tabelas para determinar quais são os mapeamentos adequados da Biblioteca de Suporte para os artefatos e as classes correspondentes do AndroidX:

Para as versões mais recentes das bibliotecas do Jetpack, consulte a página de versões.

Outros recursos

Para saber mais sobre como migrar seu código para o AndroidX, consulte os seguintes recursos extras:

Postagens do blog