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 modificados. 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 mais recentes, é possível migrar um projeto já existente para o AndroidX selecionando Refactor > Migrate to AndroidX na barra de menus.
O comando "refactor" usa duas sinalizações. Por padrão, elas são
definidas 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
- Ele também migra automaticamente as bibliotecas de terceiros já 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
- Montagem cruzada do Plaid e AndroidX (link em inglês)
- Migrar para o AndroidX: dicas, sugestões e orientação (link em inglês)