Konfiguracja biblioteki pomocy

Uwaga: wraz z wydaniem Androida 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ę wsparcia, a także najnowsze komponenty Jetpacka.

Możesz nadal korzystać z biblioteki pomocy. Historyczne artefakty (te w wersji 27 i wcześniejszych, zapakowane 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 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.

Z tego dokumentu dowiesz się, jak pobrać pakiet biblioteki Support Library i dodać biblioteki do środowiska programistycznego.

Biblioteki pomocnicze są teraz dostępne w repozytorium Maven firmy Google. 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 jakie 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: jeśli używasz klas z biblioteki wsparcia, upewnij się, że importujesz klasę z odpowiedniego pakietu. Na przykład podczas stosowania klasy ActionBar:

  • android.support.v7.app.ActionBar podczas korzystania z biblioteki wsparcia.
  • android.app.ActionBar podczas tworzenia aplikacji tylko na interfejs API na poziomie 11 lub wyższym.

Uwaga: po uwzględnieniu w projekcie aplikacji biblioteki wsparcia 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 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 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ługi preferencji w wersji 14 i bibliotekę Leanback w wersji 17, musisz użyć pakietu SDK w wersji co najmniej 17.