Konfiguracja biblioteki pomocy

Uwaga: w Androidzie 9.0 (poziom API 28) funkcja nową wersję biblioteki pomocy o nazwie AndroidX należący do Jetpack. Biblioteka AndroidX zawiera dotychczasową bibliotekę pomocy, a także najnowsze komponenty Jetpacka.

Możesz nadal korzystać z biblioteki pomocy. Historyczne artefakty (w wersji 27 lub starszej oraz spakowane jako android.support.*) będą pozostają dostępne w Google Maven. Wszystkie nowe biblioteki będą jednak rozwijane w bibliotece AndroidX.

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 Android Support Library 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 pomocnicze są teraz dostępne w repozytorium Maven firmy Google. 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. Aby na przykład dodać bibliotekę core-utils w wersji 4, dodaj: 
    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 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: jeśli używasz zajęć z Biblioteki pomocy, pamiętaj o zaimportowaniu ich z odpowiedniej pakietu. Na przykład podczas stosowania funkcji ActionBar zajęcia:

  • android.support.v7.app.ActionBar podczas korzystania z Biblioteki pomocy.
  • android.app.ActionBar w przypadku programowania wyłącznie dla interfejsu API na poziomie 11 lub wyższym.

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.

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 w Bibliotece pomocy znajdziesz w artykule pakiety android.support w dokumentacji interfejsu API.

Zmiany w deklaracji pliku manifestu

Jeśli zwiększasz zgodność wsteczną istniejącej aplikacji z poprzednią wersją interfejsu API Androida za pomocą biblioteki obsługi, zaktualizuj plik 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 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 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 zarówno bibliotekę pomocy dotyczącej preferencji wersji 14, jak i bibliotekę biblioteka Leanback v17 (minimalna), Pakiet SDK musi mieć wersję 17 lub nowszą.