Pakiety bibliotek pomocy

Uwaga: po opublikowaniu Biblioteki pomocy w wersji 28.0.0 biblioteki w pakiecie android.support zostały wycofane i zastąpione przez biblioteki Jetpack z osobnymi wersjami w pakiecie androidx. Pierwsza wersja bibliotek Jetpack w wersji 1.0.0 zapewnia spójność z Biblioteką pomocy w wersji 28.0.0 i stanowi punkt wyjścia do migracji do nowego pakietu androidx.

Istniejące biblioteki w pakiecie android.support nadal będą działać, ale nie będą otrzymywać żadnych aktualizacji w wersji późniejszej niż 28.0.0 i nie będą zgodne z nowymi bibliotekami Jetpack. Historyczne artefakty (w wersji 27 lub starszej oraz spakowane jako android.support) pozostaną dostępne w Google Maven. Wszystkie nowe artefakty zostaną spakowane jako androidx i będą wymagały migracji z android.support do androidx.

Zalecamy używanie bibliotek androidx we wszystkich nowych projektach. Rozważ też migrację istniejących projektów, aby mieć pewność, że nadal będą otrzymywać poprawki błędów i inne ulepszenia biblioteki.

Biblioteka pomocy Androida zawiera kilka pakietów bibliotek, które możesz uwzględnić w swojej aplikacji. Każda z tych bibliotek obsługuje określony zakres wersji platformy Androida i zestawu funkcji.

Aby używać tych bibliotek, musisz pobrać pliki bibliotek do instalacji pakietu Android SDK. Aby wykonać ten krok, wykonaj instrukcje pobierania bibliotek pomocy podane w artykule Konfigurowanie biblioteki pomocy. Aby dodać do aplikacji konkretną bibliotekę pomocy, musisz wykonać dodatkowe czynności. Na końcu każdej sekcji dotyczącej bibliotek poniżej znajdziesz ważne informacje na temat dodawania biblioteki do aplikacji.

Uwaga: minimalna wersja pakietu SDK dla wszystkich pakietów biblioteki pomocy to co najmniej poziom 14. Niektóre pakiety wymagają wyższego poziomu interfejsu API, jak zaznaczono poniżej.

Biblioteki pomocy technicznej w wersji 4

Te biblioteki obejmują największy zestaw interfejsów API w porównaniu z innymi bibliotekami, w tym obsługę komponentów aplikacji, funkcji interfejsu, ułatwień dostępu, obsługi danych, połączeń sieciowych i narzędzi programistycznych.

Pełne, szczegółowe informacje o klasach i metodach udostępnianych przez biblioteki pomocy w wersji 4 znajdziesz w pakiecie android.support.v4 w dokumentacji interfejsu API.

Uwaga: przed wprowadzeniem Biblioteki pomocy w wersji 24.2.0 dostępna była jedna biblioteka pomocy w wersji 4. Aby zwiększyć wydajność, podzieliliśmy tę bibliotekę na wiele modułów. Jeśli w skrypcie Gradle podasz support-v4, aby zapewnić zgodność wsteczną, aplikacja będzie zawierać wszystkie moduły w wersji 4. Jeśli jednak chcesz zmniejszyć rozmiar aplikacji, najlepiej wymień po prostu konkretne moduły potrzebne aplikacji.

biblioteka zgodna z wersją 4

Udostępnia kody zgodności wielu interfejsów API platformy, takich jak Context.obtainDrawable() i View.performAccessibilityAction().

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:support-compat:28.0.0

biblioteka v4 core-utils

Udostępnia wiele klas narzędzi, takich jak AsyncTaskLoader i PermissionChecker.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:support-core-utils:28.0.0

biblioteka Core UI w wersji 4

Implementuje różne komponenty związane z interfejsem, takie jak ViewPager, NestedScrollView i ExploreByTouchHelper.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:support-core-ui:28.0.0

biblioteka zgodna z multimediami w wersji 4

Elementy backendu platformy media, w tym MediaBrowser i MediaSession.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:support-media-compat:28.0.0

biblioteka z fragmentami w wersji 4

Dodaje obsługę hermetyzacji interfejsu użytkownika oraz funkcji za pomocą fragmentów, co umożliwia aplikacjom dostosowywanie układów między małymi a dużymi ekranami. Ten moduł wymaga zależności od interfejsów compat, core-utils, core-ui i media-compat.

Uwaga: biblioteka pomocy wersji 13 zawiera klasę FragmentCompat. Klasa Fragment w wersji 4 to samodzielna klasa, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, natomiast klasa FragmentCompat w wersji 13 udostępnia podkładki zgodności dla implementacji klasy Fragment przez platformę.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:support-fragment:28.0.0

Biblioteka pomocy Multidex

Ta biblioteka umożliwia tworzenie aplikacji z wieloma plikami wykonywalnymi Dalvik (DEX). Do używania konfiguracji multidex wymagane są aplikacje, które odwołują się do ponad 65 536 metod. Więcej informacji o korzystaniu z formatu Multidex znajdziesz w artykule o tworzeniu aplikacji przy użyciu ponad 64 tys. metod.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:multidex:1.0.0

Biblioteki pomocy technicznej v7

Te biblioteki udostępniają określone zestawy funkcji i można je dołączyć do aplikacji niezależnie od siebie.

Biblioteka appcompat w wersji 7 Część Android Jetpack.

Uwaga: biblioteka appcompat została przeniesiona do biblioteki AndroidX, która jest komponentem Android Jeetpack. Zobacz, jak go używa w aplikacji demonstracyjnej Słonecznik.

Ta biblioteka dodaje obsługę wzorca projektu paska działań interfejsu użytkownika. Ta biblioteka obsługuje implementacje interfejsu Material Design.

Uwaga: ta biblioteka korzysta z biblioteki pomocy w wersji 4.

Oto kilka najważniejszych klas zawartych w bibliotece kompatybilności aplikacji w wersji 7:

  • ActionBar – umożliwia implementację wzorca interfejsu paska działań. Więcej informacji o korzystaniu z paska działań znajdziesz w przewodniku dla programistów po pasku działań.
  • AppCompatActivity – dodaje klasę aktywności aplikacji, której można używać jako klasy podstawowej w przypadku działań korzystających z implementacji paska działań biblioteki pomocy.
  • AppCompatDialog – dodaje klasę okna, której można używać jako klasy podstawowej w oknach o tematyce AppCompat.
  • ShareActionProvider – dodaje obsługę ustandaryzowanych działań udostępniania (takich jak e-maile lub publikowanie w aplikacjach społecznościowych), które można umieścić na pasku działań.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:appcompat-v7:28.0.0

biblioteka cardview v7

Ta biblioteka obsługuje widżet CardView, który umożliwia wyświetlanie informacji na kartach o spójnym wyglądzie w dowolnej aplikacji. Karty te są przydatne w implementacjach Material Design i są często wykorzystywane w układach aplikacji na telewizory.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:cardview-v7:28.0.0

biblioteka układów siatki w wersji 7

Gdy pobierzesz biblioteki pomocy Androida, dodaje ona obsługę klasy GridLayout, która umożliwia rozmieszczanie elementów interfejsu za pomocą siatki prostokątnych komórek. Szczegółowe informacje o interfejsach API biblioteki siatki w wersji 7 znajdziesz w opisie pakietu android.support.v7.widget w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:gridlayout-v7:28.0.0

biblioteka Mediarouter v7

Ta biblioteka udostępnia MediaRouter, MediaRouteProvider i powiązane klasy multimediów, które obsługują Google Cast.

Ogólnie interfejsy API w bibliotece Mediarouter w wersji 7 umożliwiają sterowanie kierowaniem kanałów multimedialnych i strumieni z obecnego urządzenia na ekrany zewnętrzne, głośniki i inne urządzenia docelowe. Biblioteka zawiera interfejsy API do publikowania dostawców tras multimediów związanych z aplikacją, wykrywania i wybierania urządzeń docelowych, sprawdzania stanu multimediów i innych funkcji. Szczegółowe informacje o interfejsach API biblioteki Mediarouter w wersji 7 znajdziesz w opisie pakietu android.support.v7.media w dokumentacji API.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:mediarouter-v7:28.0.0

Interfejsy API biblioteki mediarouter w wersji 7 wprowadzone w bibliotece pomocy r18 mogą ulec zmianie w późniejszych wersjach biblioteki pomocy. Obecnie zalecamy korzystanie z biblioteki tylko w połączeniu z Google Cast.

biblioteka palet v7

Biblioteka obsługi palety wersji 7 zawiera klasę Palette, która umożliwia wyodrębnianie z obrazu wyraźnych kolorów. Na przykład aplikacja muzyczna może użyć obiektu Palette do wyodrębnienia głównych kolorów z okładki albumu i użyć ich do utworzenia karty tytułu utworu o skoordynowanej kolorystyce.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:palette-v7:28.0.0

biblioteka Recyclerview w wersji 7

Biblioteka recyclerview dodaje klasę RecyclerView. Ta klasa zapewnia obsługę widżetu RecyclerView, czyli widoku umożliwiającego efektywne wyświetlanie dużych zbiorów danych przez ograniczenie okna elementów danych.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:recyclerview-v7:28.0.0

Biblioteka obsługi preferencji wersji 7

Pakiet preference udostępnia interfejsy API, które umożliwiają dodawanie obiektów preferencji, takich jak CheckBoxPreference i ListPreference, w celu modyfikowania ustawień interfejsu użytkownika.

Biblioteka preferencji w wersji 7 obsługuje interfejsy takie jak Preference.OnPreferenceChangeListener i Preference.OnPreferenceClickListener oraz klasy, takie jak CheckBoxPreference i ListPreference.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:preference-v7:28.0.0

Biblioteka pomocy w wersji 8

Ta biblioteka udostępnia określone zestawy funkcji i można ją dołączyć do aplikacji niezależnie od innych bibliotek.

biblioteka renderscript v8

Ta biblioteka dodaje obsługę platformy obliczeniowej RenderScript. Te interfejsy API znajdują się w pakiecie android.support.v8.renderscript. Pamiętaj, że czynności, które musisz wykonać, aby uwzględnić te interfejsy API w swojej aplikacji, bardzo się różnią od tych w innych interfejsach API z bibliotek pomocy. Więcej informacji o używaniu tych interfejsów API w aplikacji znajdziesz w przewodniku dla programistów RenderScript.

Uwaga: użycie języka RenderScript z biblioteką pomocy jest obsługiwane w przypadku kompilacji opartych na Android Studio i Gradle. Biblioteka renderscript znajduje się w folderze build-tools/$VERSION/renderscript/.

Poniższy przykład pokazuje właściwości skryptu kompilacji Gradle w przypadku tej biblioteki:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Biblioteka pomocy w wersji 13

Ta biblioteka dodaje obsługę wzorca interfejsu użytkownika Fragment z klasą (FragmentCompat) i dodatkowymi klasami obsługi fragmentów. Więcej informacji o fragmentach znajdziesz w przewodniku dla programistów dotyczącym fragmentów. Szczegółowe informacje o interfejsach API biblioteki pomocy w wersji 13 znajdziesz w opisie pakietu android.support.v13 w dokumentacji interfejsu API.

Uwaga: biblioteka z fragmentami w wersji 4 udostępnia klasę Fragment. Klasa Fragment w wersji 4 to samodzielna klasa, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, natomiast klasa FragmentCompat w wersji 13 udostępnia podkładki zgodności dla implementacji klasy Fragment przez platformę.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:support-v13:28.0.0

Biblioteka obsługi preferencji wersji 14

Pakiet android.support.v14.preference udostępnia interfejsy API, które pozwalają dodać obsługę interfejsów preferencji, takich jak PreferenceFragment.OnPreferenceStartFragmentCallback i PreferenceFragment.OnPreferenceStartScreenCallback, oraz klas, takich jak MultiSelectListPreference i PreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki pomocy preferencji w wersji 14 znajdziesz w opisie pakietu preference w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:preference-v14:28.0.0

Biblioteka pomocy dotycząca preferencji na telewizorach w wersji 17

Pakiet android.support.v17.preference udostępnia interfejsy API umożliwiające definiowanie interfejsów preferencji na urządzeniach telewizyjnych, w tym obsługę interfejsu LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener i klas, takich jak BaseLeanbackPreferenceFragment i LeanbackPreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki pomocy preferencji w wersji 17 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

Ten pakiet wymaga interfejsu API na poziomie 17 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle wygląda tak:

 com.android.support:preference-leanback-v17:28.0.0

Biblioteka Leanback w wersji 17

Pakiet android.support.v17.leanback udostępnia interfejsy API, które ułatwiają tworzenie interfejsów użytkownika na urządzeniach telewizyjnych. Zawiera wiele ważnych widżetów aplikacji TV. Oto niektóre z najciekawszych klas:

Ten pakiet wymaga interfejsu API na poziomie 17 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle wygląda tak:

com.android.support:leanback-v17:28.0.0

Biblioteka rysowalna wektorowo

Zapewnia obsługę statycznej grafiki wektorowej.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:support-vector-drawable:28.0.0

Biblioteka rysowalna z animowanymi wektorami

Zapewnia obsługę animowanej grafiki wektorowej.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:animated-vector-drawable:28.0.0

Biblioteka obsługi adnotacji

Pakiet Annotation udostępnia interfejsy API, które umożliwiają dodawanie metadanych adnotacji do aplikacji.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:support-annotations:28.0.0

Biblioteka wsparcia dla projektów

Pakiet Design udostępnia interfejsy API, które umożliwiają dodawanie do aplikacji komponentów i wzorców Material Design.

Biblioteka pomocy dla projektowania zapewnia obsługę różnych komponentów i wzorców Material Design, z których mogą korzystać deweloperzy aplikacji, takich jak szuflady nawigacji, pływające przyciski poleceń (FAB), paski powiadomień i karty.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:design:28.0.0

Biblioteka pomocy kart niestandardowych

Pakiet Karty niestandardowe zawiera interfejsy API, które umożliwiają dodawanie kart niestandardowych i zarządzanie nimi w aplikacjach.

Biblioteka Obsługa kart niestandardowych zapewnia obsługę różnych klas, takich jak usługa kart niestandardowych i wywołanie zwrotne kart niestandardowych.

Ten pakiet wymaga interfejsu API na poziomie 15 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:customtabs:28.0.0

Biblioteka pomocy Percent

Pakiet Percent zawiera interfejsy API umożliwiające dodawanie wymiarów procentowych i zarządzanie nimi w aplikacji.

Uwaga: od wersji 26.0.0 biblioteka Percent Support jest wycofana. Klienci tego modułu powinni przejść na nowy widżet ConstraintLayout, który jest dostępny jako osobny artefakt w SDK Manager.

Biblioteka pomocy Percent umożliwia obsługę interfejsu PercentLayoutHelper.PercentLayoutParams) i różnych klas, takich jak PercentFrameLayout i PercentRelativeLayout.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:percent:28.0.0

Biblioteka pomocy ExifInterface

Tagi Exif zapisują informacje takie jak orientacja, data i godzina, informacje o aparacie i lokalizacja bezpośrednio w pliku JPEG lub RAW. Klasa ExifInterface wyłącza obsługę odczytu informacji Exif z plików JPEG i nieprzetworzonych (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW i RAF) oraz ustawia informacje Exif w plikach graficznych JPEG.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:exifinterface:28.0.0

Biblioteka pomocy rekomendacji aplikacji na telewizory

Pakiet App Recommendation udostępnia interfejsy API, które umożliwiają dodawanie rekomendacji treści w aplikacjach działających na urządzeniach telewizyjnych.

Biblioteka aplikacji obsługuje adnotacje, takie jak ContentRecommendation.ContentMaturity, i różne klasy, takie jak ContentRecommendation i RecommendationExtender.

Ten pakiet wymaga interfejsu API na poziomie 21 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:recommendation:28.0.0

Biblioteka UI Wear

Ta biblioteka zawiera interfejsy API do tworzenia interfejsów użytkownika aplikacji na Wear. Interfejsy API dostępne w pakiecie android.support.wear.Widget zastępują odpowiednie interfejsy API w bibliotece pomocy dotyczącej urządzeń do noszenia.

Więcej informacji znajdziesz w artykule Korzystanie z biblioteki interfejsu Wear.

Identyfikator zależności skryptu kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:wear:28.0.0