Uwaga: w Androidzie 9.0 (poziom interfejsu API 28) pojawiła się nowa wersja biblioteki pomocy o nazwie AndroidX, która jest częścią Jetpacka.
Biblioteka AndroidX zawiera dotychczasową bibliotekę pomocy oraz najnowsze komponenty Jetpack.
Możesz nadal korzystać z biblioteki pomocy.
Historyczne artefakty (w wersji 27 lub starszej oraz spakowane jako android.support.*
) pozostaną dostępne w Google Maven. Nowe biblioteki będą jednak tworzone w bibliotece AndroidX.
Zalecamy używanie bibliotek AndroidaX we wszystkich nowych projektach. Rozważ też migrację istniejących projektów do AndroidaX.
Sposób konfiguracji bibliotek pomocy dotyczącej Androida w projekcie programistycznym zależy od tego, jakich funkcji chcesz użyć i jakie wersje platformy Androida chcesz obsługiwać w swojej aplikacji.
Ten dokument zawiera instrukcje pobierania pakietu biblioteki pomocy i dodawania bibliotek do środowiska programistycznego.
Biblioteki pomocy są teraz dostępne w repozytorium Google Maven. Nie obsługujemy już pobierania bibliotek za pomocą Menedżera SDK, a ta funkcja zostanie wkrótce usunięta.
Wybieranie bibliotek pomocy
Zanim dodasz Bibliotekę pomocy do swojej aplikacji, zdecyduj, które funkcje chcesz uwzględnić oraz jakie najniższe wersje Androida mają być obsługiwane. Więcej informacji o funkcjach udostępnianych przez różne biblioteki znajdziesz w artykule o funkcjach biblioteki pomocy.
Dodawanie bibliotek pomocy
Aby korzystać z biblioteki pomocy, musisz zmodyfikować zależności ścieżki klasy aplikacji w środowisku programistycznym. Musisz wykonać tę procedurę w przypadku każdej biblioteki pomocy, której chcesz używać.
Aby dodać bibliotekę pomocy do projektu aplikacji:
- Dodaj repozytorium Maven Google do pliku
settings.gradle
projektu.dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must // instead use: // // maven { // url 'https://maven.google.com' // } } }
- Do każdego modułu, w którym chcesz korzystać z biblioteki pomocy, dodaj bibliotekę w bloku
dependencies
plikubuild.gradle
modułu. Aby na przykład dodać bibliotekę v4 core-utils, dodaj ten fragment:dependencies { ... implementation "com.android.support:support-core-utils:28.0.0" }
Uwaga: korzystanie z zależności dynamicznych (np. palette-v7:23.0.+
) może spowodować nieoczekiwane aktualizacje wersji i niezgodności w regresji. Zalecamy jawne podanie wersji biblioteki (np. palette-v7:28.0.0
).
Korzystanie z interfejsów API biblioteki pomocy
Klasy biblioteki pomocy zapewniające obsługę istniejących interfejsów API platformy zwykle mają taką samą nazwę jak klasa platformy, ale znajdują się w pakietach klas android.support
lub mają sufiks *Compat
.
Uwaga: jeśli używasz zajęć z biblioteki pomocy, pamiętaj, aby zaimportować je z odpowiedniego pakietu. Na przykład podczas stosowania klasy ActionBar
:
android.support.v7.app.ActionBar
podczas korzystania z Biblioteki pomocy.android.app.ActionBar
w przypadku programowania wyłącznie dla interfejsu API na poziomie 11 lub wyższym.
Uwaga: gdy uwzględnisz Bibliotekę pomocy w projekcie aplikacji, zdecydowanie zalecamy zmniejszenie i zaciemnienie aplikacji oraz jej optymalizację przed opublikowaniem. Zmniejszenie pomaga nie tylko chronić kod źródłowy za pomocą zaciemniania, ale i usuwać nieużywane klasy ze wszystkich bibliotek dołączonych do aplikacji. Dzięki temu rozmiar pobieranej aplikacji jest jak najmniejszy.
Dalsze wskazówki dotyczące korzystania z niektórych funkcji Biblioteki pomocy znajdziesz w klasach szkoleniowych, przewodnikach i przykładach dla programistów aplikacji na Androida. Więcej informacji o poszczególnych klasach i metodach biblioteki pomocy znajdziesz w opisie pakietów android.support
w dokumentacji interfejsu API.
Zmiany w deklaracji w pliku manifestu
Jeśli zwiększasz zgodność wsteczną istniejącej aplikacji do wcześniejszej wersji interfejsu Android API za pomocą biblioteki pomocy, pamiętaj o zaktualizowaniu pliku manifestu aplikacji. W szczególności musisz zaktualizować element android:minSdkVersion
tagu
<uses-sdk>
w pliku manifestu do nowego, niższego numeru wersji, jak pokazano poniżej:
<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="23" />
Ustawienie w pliku manifestu informuje Google Play, że Twoją aplikację można zainstalować na urządzeniach z Androidem 4.0 (poziom interfejsu API 14) lub nowszym.
Jeśli używasz plików kompilacji Gradle, ustawienie minSdkVersion
w pliku kompilacji zastępuje ustawienia manifestu.
plugins { id 'com.android.application' } android { ... defaultConfig { minSdkVersion 16 ... } ... }
W tym przypadku ustawienie pliku kompilacji informuje Google Play, że domyślny wariant kompilacji aplikacji można zainstalować na urządzeniach z Androidem 4.1 (poziom interfejsu API 16) lub nowszym. Więcej informacji o wariantach kompilacji znajdziesz w artykule Omówienie tworzenia systemu.
Uwaga: jeśli używasz kilku bibliotek pomocniczych, minimalna wersja pakietu SDK musi być najnowszą wersją wymaganą przez dowolną z wymienionych bibliotek. Jeśli na przykład Twoja aplikacja zawiera zarówno bibliotekę obsługi preferencji wersji 14, jak i bibliotekę Leanback w wersji 17, minimalna wersja pakietu SDK musi być w wersji 17 lub nowszej.