Konfiguracja biblioteki pomocy

Uwaga: wraz z Androidem 9.0 (poziom interfejsu API 28) pojawiła się nowa wersja biblioteki obsługi o nazwie AndroidX, która jest częścią pakietu Jetpack. 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. Wszystkie nowe biblioteki będą jednak rozwijane w bibliotece AndroidX.

W przypadku wszystkich nowych projektów zalecamy używanie bibliotek AndroidX. Warto też przenieść istniejące projekty do AndroidX.

Sposób konfiguracji bibliotek Android Support Libraries w projekcie programistycznym zależy od tego, których funkcji chcesz używać i jakie wersje platformy Android 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 pakietu SDK. Ta funkcja zostanie wkrótce usunięta.

Wybieranie bibliotek pomocy

Zanim dodasz do aplikacji bibliotekę wsparcia, zdecyduj, jakie funkcje chcesz uwzględnić oraz które najstarsze wersje Androida chcesz obsługiwać. Więcej informacji o funkcjach dostępnych w różnych bibliotekach znajdziesz w artykule Funkcje bibliotek pomocy.

Dodawanie bibliotek pomocniczych

Aby korzystać z biblioteki wsparcia, musisz zmodyfikować zależności classpath projektu aplikacji w środowisku programistycznym. Musisz wykonać tę procedurę w przypadku każdej biblioteki wsparcia, której chcesz używać.

Aby dodać bibliotekę wsparcia do projektu aplikacji:

1. Uwzględnij repozytorium Maven firmy Google w 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ę core-utils w wersji 4, dodaj:

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

Uwaga: używanie dynamicznych zależności (np. palette-v7:23.0.+) może powodować nieoczekiwane aktualizacje wersji i niezgodności regresji. Zalecamy wyraźne określenie wersji biblioteki (na przykład palette-v7:28.0.0).

Korzystanie z interfejsów API biblioteki pomocy

Klasy biblioteki pomocniczej, które obsługują istniejące interfejsy API frameworku, mają zwykle tę samą nazwę co klasa frameworku, ale znajdują się w pakietach klas android.support lub mają sufiks *Compat.

Uwaga: po uwzględnieniu biblioteki Support Library w projekcie aplikacji zdecydowanie zalecamy zmniejszenie rozmiaru, zaciemnienie i zoptymalizowanie aplikacji przed jej opublikowaniem. Oprócz ochrony kodu źródłowego za pomocą zaciemnienia, zmniejszanie kodu usuwa z bibliotek zawartych w aplikacji nieużywane klasy, dzięki czemu rozmiar aplikacji do pobrania jest jak najmniejszy.

Więcej wskazówek dotyczących korzystania z niektórych funkcji biblioteki wsparcia znajdziesz w zajęciach szkoleniowych, przewodnikach i przykładach dla deweloperów aplikacji na Androida. Więcej informacji o poszczególnych klasach i metodach biblioteki pomocy znajdziesz w pakietach 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 w tagu <uses-sdk> w pliku manifestu, podając nowy, niższy numer wersji:

  <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ąpi ustawienia w pliku manifestu.

plugins {
  id 'com.android.application'
}

android {
    ...

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

W takim przypadku ustawienie pliku kompilacji informuje Google Play, że domyślna wersja kompilacji aplikacji może być instalowana 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 używasz kilku bibliotek pomocniczych, minimalna wersja pakietu SDK musi być najnowsza, wymagana przez dowolną z wymienionych bibliotek. Jeśli na przykład Twoja aplikacja zawiera bibliotekę obsługującą preferencje w wersji 14 i bibliotekę Leanback w wersji 17, musisz użyć pakietu SDK w wersji co najmniej 17.