Omówienie AndroidaX

Przestrzeń nazw androidx obejmuje biblioteki Android Jetpack. Podobnie jak Biblioteka pomocy, biblioteki w przestrzeni nazw androidx są dostarczane oddzielnie od platformy Android i zapewniają zgodność wsteczną we wszystkich wersjach Androida.

AndroidX to duże ulepszenie oryginalnej Biblioteki pomocy Androida Support Library, która nie jest już utrzymywana. Pakiety androidx w pełni zastępują Bibliotekę pomocy, ponieważ zapewniają te same funkcje i nowe biblioteki.

AndroidX obejmuje też te funkcje:

• Wszystkie pakiety w AndroidX znajdują się w spójnej przestrzeni nazw zaczynającej się od ciągu androidx. Pakiety Biblioteki pomocy zostały zmapowane na odpowiednie pakiety androidx.*. Pełne mapowanie wszystkich starych klas i artefaktów kompilacji na nowe znajdziesz na stronie Refaktoryzacja pakietu.

• W przeciwieństwie do Biblioteki pomocy pakiety androidx są utrzymywane i aktualizowane oddzielnie. Pakiety androidx używają ścisłego semantycznego wersjonowania, zaczynając od wersji 1.0.0. Biblioteki AndroidX możesz aktualizować w projekcie niezależnie.

• Wersja 28.0.0 to ostatnie wydanie Biblioteki pomocy. Nie będzie już żadnych wydań biblioteki android.support. Wszystkie nowe funkcje będą opracowywane w przestrzeni nazw androidx.

Uwaga: biblioteki Jetpack nie wysyłają żadnych danych użytkowników do żadnej usługi backendu. Oznacza to, że zintegrowanie biblioteki Jetpack z aplikacją nie ma wpływu na formularz Bezpieczeństwa danych w Konsoli Play.

Używanie bibliotek androidx w projekcie

Aktualny AGP domyślnie obsługuje używanie bibliotek androidx. Aby dowiedzieć się, jak przeprowadzić migrację istniejącego projektu, przeczytaj artykuł Migracja do AndroidX.

W przypadku projektów, które nie zostały zmigrowane lub mają starsze zależności, które nie zostały zmigrowane, AGP udostępnia te flagi, które można ustawić w pliku projektu gradle.properties.

• android.useAndroidX: domyślnie ustawiona na true w wtyczce Androida do obsługi Gradle 9.0.0 i nowszych, a na false w wersjach wcześniejszych niż 9.0.0. Gdy ta flaga jest ustawiona na true, wtyczka Androida używa odpowiedniej biblioteki AndroidX zamiast Biblioteki pomocy. Możliwość ustawienia tej flagi na false zostanie usunięta w AGP 10.
• android.enableJetifier: gdy ta flaga jest ustawiona na true, wtyczka Androida automatycznie migruje istniejące biblioteki innych firm, aby używały zależności AndroidX, przez przepisanie ich plików binarnych. Jeśli flaga nie jest określona, domyślnie ma wartość false. Zostanie usunięta w AGP 10, ponieważ opublikowane biblioteki na ogół zakończyły migrację.

Uwaga: Biblioteki w androidx oficjalnie obsługują narzędzie do kompilacji Gradle z wtyczką Android Gradle Plugin i nie testują ani nie utrzymują zgodności z żadną inną konfiguracją kompilacji.

Dokumentacja API

Wszystkie pakiety i klasy w przestrzeni nazw androidx znajdziesz w sekcji Dokumentacja AndroidX.

Dodatkowe materiały

Więcej informacji o komponentach znajdziesz na stronie głównej Jetpack home page. Więcej informacji o refaktoryzacji pakietu z Biblioteki pomocy do androidx, znajdziesz w tym poście na blogu.