Konfiguracja biblioteki pomocy

Uwaga: w Androidzie 9.0 (poziom API 28) funkcja nową wersję biblioteki pomocy o nazwie AndroidX należący do Jetpack. Biblioteka AndroidaX zawiera istniejącą bibliotekę pomocy oraz najnowsze komponenty Jetpack.

Nadal możesz korzystać z biblioteki pomocy. Historyczne artefakty (w wersji 27 lub starszej oraz spakowane jako android.support.*) będą pozostają dostępne w Google Maven. Jednak nowe biblioteki pojawi się w bibliotece AndroidaX.

Zalecamy używanie bibliotek AndroidaX we wszystkich nowych projektach. Warto też wziąć pod uwagę przeniesiemy też istniejące projekty do AndroidaX.

Sposób konfiguracji bibliotek pomocy dotyczącej Androida w projekcie programistycznym zależy od tego, jakie funkcje których chcesz używać i jaką gamę wersji platformy Androida chcesz obsługiwać aplikacji.

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

Biblioteki pomocy są teraz dostępne w narzędziu Maven Google z repozytorium. Nie obsługujemy już pobierania bibliotek za pomocą pakietu SDK Menedżer, 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 najniższe wersje Androida, które chcesz obsługiwać. Więcej informacji o funkcjach udostępniane przez różne biblioteki, zobacz Funkcje Biblioteki pomocy.

Dodawanie bibliotek pomocy

Aby korzystać z biblioteki pomocy, musisz zmodyfikować ścieżki klasy w środowisku programistycznym. Musisz wykonać tę procedurę dla z bibliotek pomocy technicznej, których chcesz używać.

Aby dodać bibliotekę pomocy do projektu aplikacji:

1. Uwzględnij repozytorium Maven Google w pliku settings.gradle.

   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 dependencies blok pliku build.gradle modułu. Dla: Aby dodać bibliotekę v4 core-utils, dodaj następujące elementy:

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

Uwaga: korzystaj z zależności dynamicznych (np. palette-v7:23.0.+) mogą powodować nieoczekiwane aktualizacje wersji i niezgodność regresji. Zalecamy wyraźne określenie tagu wersję biblioteki (np. palette-v7:28.0.0).

Korzystanie z interfejsów API biblioteki pomocy

Klasy w bibliotece pomocy zapewniające obsługę istniejących interfejsów API platformy zwykle mają taka sama jak klasa platformy, ale znajdują się w pakietach klas android.support, lub ma sufiks *Compat.

Uwaga: po włączeniu biblioteki pomocy do projektu aplikacji zdecydowanie zalecamy zmniejszanie, zaciemnianie i optymalizację aplikację do opublikowania. Oprócz ochrony kodu źródłowego przez zaciemnianie kodu, usuwa nieużywane klasy ze wszystkich bibliotek dołączonych do aplikacji, dzięki czemu jak najmniejszy do pobrania.

Dalsze wskazówki dotyczące korzystania z niektórych funkcji Biblioteki pomocy znajdziesz w aplikacji dla deweloperów aplikacji na Androida. zajęcia szkoleniowe, przewodniki i przykłady. Więcej informacji o poszczególnych klasach i metodach w Bibliotece pomocy znajdziesz w artykule pakiety android.support w dokumentacji interfejsu API.

Zmiany w deklaracji w pliku manifestu

Jeśli zwiększasz zgodność wsteczną istniejącej aplikacji do starszej za pomocą biblioteki pomocy technicznej, pamiętaj, by zaktualizować pliku manifestu. W szczególności musisz zaktualizować android:minSdkVersion element <uses-sdk> w pliku manifestu na nowy, niższy numer wersji, 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 nowszego.

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 pliku kompilacji informuje Google Play, że domyślny wariant kompilacji można instalować na urządzeniach z Androidem 4.1 (poziom interfejsu API 16) lub nowszym. Więcej informacje na temat wariantów kompilacji, zobacz Omówienie systemu kompilacji.

Uwaga: jeśli dodajesz kilka bibliotek pomocniczych, atrybut minimalna wersja pakietu SDK musi być najnowszą wersją wymaganą przez dowolną określonych bibliotekach. Jeśli na przykład Twoja aplikacja zawiera zarówno bibliotekę pomocy dotyczącej preferencji wersji 14, jak i bibliotekę biblioteka Leanback v17 (minimalna), Pakiet SDK musi mieć wersję 17 lub nowszą.