Konfiguracja biblioteki pomocy

Uwaga: w wersji Androida 9.0 (poziom interfejsu API 28) udostępniamy nową wersję biblioteki pomocy o nazwie AndroidX, która jest częścią usługi Jetpack. Biblioteka AndroidX zawiera istniejącą bibliotekę pomocy i najnowsze komponenty Jetpack.

Możesz nadal korzystać z biblioteki pomocy. Historyczne artefakty (w wersji 27 i starszych i spakowane jako android.support.*) pozostaną dostępne w Google Maven. Wszystkie nowe projekty będą jednak odbywać się w bibliotece AndroidX.

Zalecamy używanie bibliotek AndroidX we wszystkich nowych projektach. Rozważ też migrację istniejących projektów na AndroidaX.

Sposób konfigurowania bibliotek pomocy Androida w projekcie programistycznym zależy od tego, jakich funkcji chcesz używać i jakie wersje platformy Androida mają obsługiwać w swojej aplikacji.

Ten dokument zawiera instrukcje pobierania pakietu Biblioteki pomocy i dodawania bibliotek do środowiska programistycznego.

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

Wybieranie bibliotek pomocy

Zanim dodasz Bibliotekę pomocy do aplikacji, zdecyduj, które funkcje chcesz uwzględnić i które najniższe wersje Androida mają być obsługiwane. Więcej informacji o funkcjach dostępnych w różnych bibliotekach znajdziesz w artykule Funkcje bibliotek 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żyć.

Aby dodać Bibliotekę pomocy do projektu aplikacji:

1. Dodaj repozytorium Google Maven do pliku settings.gradle swojego 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 każdym module, w którym chcesz korzystać z biblioteki pomocy, dodaj ją w bloku dependencies pliku build.gradle modułu. Aby na przykład dodać bibliotekę Core-utils w wersji 4, dodaj ten kod:

   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 regresji. Zalecamy jawne określenie wersji biblioteki (np. palette-v7:28.0.0).

Korzystanie z interfejsów API biblioteki pomocy

Klasy biblioteki pomocy obsługujące istniejące interfejsy API platformy zwykle mają taką samą nazwę jak klasa platformy, ale znajdują się w pakietach klas android.support lub mają sufiks *Compat.

Uwaga: po dołączeniu biblioteki pomocy do projektu aplikacji zdecydowanie zalecamy zmniejszenie, zaciemnienie i zoptymalizowanie aplikacji pod kątem publikacji. Zmniejszanie rozmiaru nie tylko zabezpiecza kod źródłowy za pomocą zaciemniania kodu, ale powoduje usunięcie nieużywanych klas ze wszystkich bibliotek dodanych do aplikacji, dzięki czemu jej rozmiar do pobrania jest jak najmniejszy.

Dalsze wskazówki dotyczące korzystania z niektórych funkcji Biblioteki pomocy znajdziesz w klasach szkoleniowych, przewodnikach i przykładach dla deweloperów aplikacji na Androida. Więcej informacji o poszczególnych klasach i metodach Biblioteki pomocy znajdziesz w informacjach o pakietach android.support w dokumentacji interfejsu API.

Zmiany deklaracji pliku manifestu

Jeśli zwiększasz zgodność wsteczną swojej istniejącej aplikacji do wcześniejszej wersji interfejsu Android API z biblioteką 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 instalować 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 tym przypadku ustawienie pliku kompilacji informuje Google Play, że domyślny wariant kompilacji Twojej aplikacji może zostać zainstalowany na urządzeniach z Androidem 4.1 (poziom interfejsu API 16) lub nowszym. Więcej informacji o wariantach kompilacji znajdziesz w artykule o omówieniu systemu kompilacji.

Uwaga: jeśli udostępniasz kilka bibliotek obsługiwanych, minimalna wersja pakietu SDK musi być najwyższą wersją wymaganą przez dowolne z podanych bibliotek. Jeśli na przykład aplikacja zawiera zarówno bibliotekę obsługi preferencji w wersji 14, jak i bibliotekę funkcji TalkBack w wersji 17, minimalna wersja SDK musi mieć wersję 17 lub nowszą.