Konfiguracja biblioteki pomocy

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:

1. 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'
           // }
       }
   }
   

2. Do każdego modułu, w którym chcesz korzystać z biblioteki pomocy, dodaj bibliotekę w bloku dependencies pliku build.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: 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.