AndroidX zastępuje pierwotne interfejsy API biblioteki pomocy pakietami w przestrzeni nazw androidx
. Zmieniły się tylko nazwy pakietu i artefaktów Maven. Nazwy klas, metod i pól nie uległy zmianie.
Wymagania wstępne
Przed migracją zaktualizuj aplikację. Zalecamy zaktualizowanie projektu tak, aby wykorzystywał ostateczną wersję biblioteki pomocy: wersja 28.0.0. Wynika to z faktu, że artefakty AndroidaX w wersji 1.0.0 są binarnymi odpowiednikami artefaktów Biblioteki pomocy 28.0.0.
Przeprowadź migrację istniejącego projektu za pomocą Android Studio
W Android Studio w wersji 3.2 lub nowszej możesz przenieść istniejący projekt na AndroidaX, wybierając na pasku menu Refaktor > Przenieś na Androida X.
Polecenie refaktoryzacji wykorzystuje 2 flagi. Domyślnie oba te wartości w pliku gradle.properties
mają wartość true
:
android.useAndroidX=true
- Wtyczka do Androida używa odpowiedniej biblioteki AndroidX zamiast biblioteki pomocy.
android.enableJetifier=true
- Wtyczka na Androida automatycznie przenosi istniejące biblioteki innych firm do AndroidaX przez przepisanie ich plików binarnych.
Mapowania
Jeśli napotkasz problemy z migracją, sprawdź w tych tabelach, gdzie znajdują się właściwe mapowania z biblioteki pomocy do odpowiednich artefaktów i klas AndroidaX:
Najnowsze wersje bibliotek Jetpack znajdziesz na stronie z wersjami.
Dodatkowe materiały
Więcej informacji o migracji kodu na AndroidaX znajdziesz w tych dodatkowych materiałach: