Konfiguracja biblioteki pomocy

Uwaga: wraz z wydaniem Androida 9.0 (poziom interfejsu API 28) pojawiła się nowa wersja biblioteki pomocy o nazwie AndroidX, która jest częścią Jetpack. Biblioteka AndroidX zawiera dotychczasową bibliotekę pomocy, a także najnowsze komponenty Jetpack.

Możesz nadal korzystać z biblioteki pomocy. Starsze artefakty (wersje 27 i starsze, spakowane jako android.support.*) pozostaną dostępne w Google Maven. Jednak wszystkie nowe biblioteki będą tworzone w bibliotece AndroidX.

We wszystkich nowych projektach zalecamy używanie bibliotek AndroidX. Warto też rozważyć migrację dotychczasowych projektów do AndroidX.

Sposób konfigurowania bibliotek pomocy Androida w projekcie zależy od tego, z jakich funkcji chcesz korzystać i jakie wersje platformy Android chcesz obsługiwać w swojej aplikacji.

Z tego dokumentu dowiesz się, jak pobrać pakiet biblioteki pomocy i dodać biblioteki do środowiska programistycznego.

Biblioteki pomocy są teraz dostępne w repozytorium Google Maven. Nie obsługujemy już pobierania bibliotek za pomocą Menedżera pakietów SDK, a ta funkcja zostanie wkrótce usunięta.

Wybieranie bibliotek pomocy

Zanim dodasz bibliotekę pomocy do aplikacji, zdecyduj, jakie funkcje chcesz uwzględnić i jakie najstarsze wersje Androida chcesz obsługiwać. Więcej informacji o funkcjach udostępnianych przez różne biblioteki znajdziesz w artykule Funkcje biblioteki pomocy.

Dodawanie bibliotek pomocy

Aby korzystać z biblioteki pomocy, musisz zmodyfikować zależności ścieżki klasy projektu 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:

1. Dodaj repozytorium Google Maven 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'
           // }
       }
   }

2. W przypadku każdego modułu, w którym chcesz używać biblioteki pomocy, dodaj bibliotekę w bloku dependencies pliku build.gradle modułu. Aby na przykład dodać bibliotekę v4 core-utils, dodaj ten kod:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }

Uwaga: używanie zależności dynamicznych (np. palette-v7:23.0.+) może powodować nieoczekiwane aktualizacje wersji i problemy z regresją. Zalecamy wyraźne określenie wersji biblioteki (np. palette-v7:28.0.0).

Korzystanie z interfejsów API biblioteki pomocy

Klasy biblioteki pomocy, które obsługują dotychczasowe interfejsy API platformy, mają zwykle taką samą nazwę jak klasy platformy, ale znajdują się w pakietach klas android.support lub mają sufiks *Compat.

Uwaga: po dodaniu biblioteki pomocy do projektu aplikacji zdecydowanie zalecamy zmniejszenie, zaciemnienie i zoptymalizowanie aplikacji pod kątem publikacji. Oprócz ochrony kodu źródłowego za pomocą zaciemniania zmniejszanie usuwa nieużywane klasy z bibliotek dołączonych do aplikacji, co pozwala utrzymać jak najmniejszy rozmiar pobierania aplikacji.

Dodatkowe wskazówki dotyczące korzystania z niektórych funkcji biblioteki pomocy znajdziesz w kursach, przewodnikach i przykładach dla programistów Androida. Więcej informacji o poszczególnych klasach i metodach Biblioteki pomocy znajdziesz w dokumentacji API w pakietach android.support.

Zmiany w deklaracji pliku manifestu

Jeśli zwiększasz zgodność wsteczną dotychczasowej aplikacji z wcześniejszą wersją interfejsu API Androida za pomocą biblioteki pomocy, zaktualizuj plik manifestu aplikacji. W szczególności zaktualizuj element android:minSdkVersion <uses-sdk> tagu w pliku manifestu do nowej, niższej wersji, jak pokazano poniżej:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Ustawienie w pliku manifestu informuje Google Play, że 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 pliku manifestu.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

W takim przypadku ustawienie w 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 systemu kompilacji.

Uwaga: jeśli dołączasz kilka bibliotek pomocy, minimalna wersja pakietu SDK musi być najwyższą wersją wymaganą przez którąkolwiek z określonych bibliotek. Jeśli na przykład aplikacja zawiera zarówno bibliotekę v14 Preference Support, jak i bibliotekę v17 Leanback, minimalna wersja pakietu SDK musi być 17 lub nowsza.