Pakiety bibliotek pomocy

Uwaga: wraz z wydaniem Biblioteki pomocy w wersji 28.0.0 biblioteki w pakiecie android.support zostały wycofane i zastąpione bibliotekami Jetpack z indywidualnymi numerami wersji, które są dostępne w pakiecie androidx. Pierwsza wersja bibliotek Jetpack (1.0.0 ) jest równoważna z Biblioteką pomocy w wersji 28.0.0 i stanowi punkt wyjścia do migracji na nowy androidx pakiet.

Dotychczasowe biblioteki w pakiecie android.support będą nadal działać, ale one nie będą już aktualizowane po wersji 28.0.0 i nie będą zgodne z nowymi bibliotekami Jetpack. Historyczne artefakty (w wersjach 27 i starszych, dostępne w pakiecie android.support) pozostaną dostępne w Google Maven. Wszystkie nowe artefakty będą dostępne w pakiecie androidx i będą wymagać migracji z android.support na androidx.

We wszystkich nowych projektach zalecamy używanie bibliotek androidx. Warto też rozważyć migrację dotychczasowych projektów, aby nadal otrzymywać poprawki błędów i inne ulepszenia bibliotek.

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

Aby korzystać z którejkolwiek z tych bibliotek, musisz pobrać pliki biblioteki do swojej instalacji Android SDK. Aby wykonać ten krok, postępuj zgodnie z instrukcjami pobierania bibliotek pomocy w artykule Konfigurowanie bibliotek pomocy. Aby uwzględnić w aplikacji konkretną bibliotekę pomocy, musisz wykonać dodatkowe czynności. Ważne informacje o tym, jak uwzględnić bibliotekę w aplikacji, znajdziesz na końcu każdej sekcji biblioteki poniżej.

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

Biblioteki pomocy v4

Te biblioteki zawierają największy zestaw interfejsów API w porównaniu z innymi bibliotekami, w tym obsługę komponentów aplikacji, funkcji interfejsu użytkownika, ułatwień dostępu, obsługi danych, łączności sieciowej i narzędzi programistycznych

Szczegółowe informacje o klasach i metodach udostępnianych przez biblioteki pomocy v4 znajdziesz w pakiecie android.support.v4 w dokumentacji API.

Uwaga: przed wersją 24.2.0 Biblioteki pomocy istniała tylko jedna biblioteka pomocy v4. Aby zwiększyć wydajność, biblioteka ta została podzielona na kilka modułów. Aby zachować zgodność wsteczną, jeśli w skrypcie Gradle wymienisz support-v4, Twoja aplikacja będzie zawierać wszystkie moduły v4. Aby jednak zmniejszyć rozmiar aplikacji, zalecamy, aby wymienić tylko te moduły, których potrzebuje Twoja aplikacja.

Biblioteka v4 compat

Zawiera otoki zgodności dla wielu interfejsów API platformy, takich jak Context.obtainDrawable() i View.performAccessibilityAction().

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:support-compat:28.0.0

Biblioteka v4 core-utils

Zawiera wiele klas narzędziowych, takich jak AsyncTaskLoader i PermissionChecker.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

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

Biblioteka v4 core-ui

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

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

Biblioteka v4 media-compat

Zawiera porty wsteczne części platformy multimedialnej, w tym MediaBrowser i MediaSession.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

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

Biblioteka v4 fragment

Dodaje obsługę hermetyzacji interfejsu użytkownika i funkcji za pomocą fragmentów, co umożliwia aplikacjom udostępnianie układów, które dostosowują się do urządzeń z małymi i dużymi ekranami. Ten moduł ma zależności od bibliotek compat, core-utils, core-ui i media-compat.

Uwaga: Biblioteka pomocy v13 zawiera klasę FragmentCompat. Klasa v4 Fragment to samodzielna klasa, która zawiera poprawki błędów dodane w nowszych wersjach platformy, natomiast klasa v13 FragmentCompat zawiera shimy zgodności dla implementacji platformy klasy Fragment.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

com.android.support:support-fragment:28.0.0

Biblioteka pomocy multidex

Ta biblioteka obsługuje tworzenie aplikacji z wieloma plikami Dalvik Executable (DEX). Aplikacje, które odwołują się do ponad 65 536 metod, muszą korzystać z konfiguracji multidex. Więcej informacji o korzystaniu z multidex znajdziesz w artykule Tworzenie aplikacji z ponad 64 tys. metod.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

com.android.support:multidex:1.0.0

Biblioteki pomocy v7

Te biblioteki udostępniają określone zestawy funkcji i można je uwzględnić w aplikacji niezależnie od siebie.

Biblioteka v7 appcompat   Część Androida Jetpack.

Uwaga:Biblioteka appcompat została przeniesiona do biblioteki AndroidX, która jest komponentem Android Jetpack. Zobacz, jak jest używana w aplikacji w wersji demonstracyjnej Sunflower.

Ta biblioteka dodaje obsługę paska działań wzorca projektowego interfejsu użytkownika. Ta biblioteka obejmuje obsługę implementacji interfejsu użytkownika Material Design.

Uwaga: ta biblioteka jest zależna od Biblioteki pomocy v4.

Oto kilka najważniejszych klas zawartych w bibliotece v7 appcompat:

  • ActionBar – udostępnia implementację wzorca projektowego interfejsu użytkownika paska działań . Więcej informacji o korzystaniu z paska działań znajdziesz w przewodniku dla programistów dotyczącym paska działań.
  • AppCompatActivity – dodaje klasę aktywności aplikacji, która może być używana jako klasa bazowa dla aktywności korzystających z implementacji paska działań Biblioteki pomocy.
  • AppCompatDialog – dodaje klasę okna dialogowego, która może być używana jako klasa bazowa dla okien dialogowych z motywem AppCompat.
  • ShareActionProvider – dodaje obsługę standardowego działania udostępniania (np. e-maila lub posta w aplikacjach społecznościowych), które można uwzględnić na pasku działań.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:appcompat-v7:28.0.0

Biblioteka v7 cardview

Ta biblioteka dodaje obsługę widżetu CardView, który umożliwia wyświetlanie informacji w kartach o spójnym wyglądzie w każdej aplikacji. Te karty są przydatne w implementacjach Material Design i są szeroko stosowane w układach aplikacji na telewizory.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:cardview-v7:28.0.0

Biblioteka v7 gridlayout

Po pobraniu bibliotek pomocy Androida ta biblioteka dodaje obsługę klasy GridLayout, która umożliwia rozmieszczanie elementów interfejsu użytkownika za pomocą siatki prostokątnych komórek. Szczegółowe informacje o interfejsach API biblioteki v7 gridlayout znajdziesz w pakiecie android.support.v7.widget w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:gridlayout-v7:28.0.0

Biblioteka v7 mediarouter

Ta biblioteka zawiera MediaRouter, MediaRouteProvider i powiązane klasy multimedialne, które obsługują Google Cast.

Ogólnie rzecz biorąc, interfejsy API w bibliotece v7 mediarouter umożliwiają sterowanie routingiem kanałów i strumieni multimedialnych z bieżącego urządzenia na ekrany zewnętrzne, głośniki i inne urządzenia docelowe. Biblioteka zawiera interfejsy API do publikowania dostawców tras multimedialnych specyficznych dla aplikacji, do wykrywania i wybierania urządzeń docelowych, do sprawdzania stanu multimediów i nie tylko. Szczegółowe informacje o interfejsach API biblioteki v7 mediarouter znajdziesz w pakiecie android.support.v7.media w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:mediarouter-v7:28.0.0

Interfejsy API biblioteki v7 mediarouter wprowadzone w Bibliotece pomocy r18 mogą ulec zmianie w późniejszych wersjach Biblioteki pomocy. Obecnie zalecamy używanie tej biblioteki tylko w połączeniu z Google Cast.

Biblioteka v7 palette

Biblioteka pomocy v7 palette zawiera klasę Palette, która umożliwia wyodrębnianie wyróżniających się kolorów z obrazu. Na przykład aplikacja muzyczna może używać obiektu Palette do wyodrębniania głównych kolorów z okładki albumu i używać tych kolorów do tworzenia karty tytułowej utworu.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:palette-v7:28.0.0

Biblioteka v7 recyclerview

Biblioteka recyclerview dodaje klasę RecyclerView. Ta klasa obsługuje widżet RecyclerView, czyli widok do wydajnego wyświetlania dużych zbiorów danych przez udostępnianie ograniczonego okna elementów danych.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:recyclerview-v7:28.0.0

Biblioteka pomocy v7 Preference

Pakiet preference udostępnia interfejsy API do dodawania obiektów preferencji, takich jak CheckBoxPreference i ListPreference, aby użytkownicy mogli modyfikować ustawienia interfejsu.

Biblioteka v7 Preference dodaje obsługę interfejsów, takich jak Preference.OnPreferenceChangeListener i Preference.OnPreferenceClickListener, oraz klas, takich jak CheckBoxPreference i ListPreference.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:preference-v7:28.0.0

Biblioteka pomocy v8

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

Biblioteka v8 renderscript

Ta biblioteka dodaje obsługę platformy obliczeniowej RenderScript. Te interfejsy API są zawarte w pakiecie android.support.v8.renderscript. Pamiętaj, że kroki wymagane do uwzględnienia tych interfejsów API w aplikacji bardzo różnią się od kroków wymaganych w przypadku innych interfejsów API Biblioteki pomocy. Więcej informacji o korzystaniu z tych interfejsów API w aplikacji znajdziesz w przewodniku dla programistów dotyczącym RenderScript.

Uwaga: używanie RenderScript z Biblioteką pomocy jest obsługiwane w Android Studio i kompilacjach opartych na Gradle. Biblioteka renderscript znajduje się w folderze build-tools/$VERSION/renderscript/.

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Biblioteka pomocy v13

Ta biblioteka dodaje obsługę wzorca interfejsu użytkownika Fragment za pomocą klasy (FragmentCompat) i dodatkowych klas 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 v13 znajdziesz w pakiecie android.support.v13 w dokumentacji interfejsu API.

Uwaga: Biblioteka v4 fragment zawiera klasę Fragment. Klasa v4 Fragment to samodzielna klasa, która zawiera poprawki błędów dodane w nowszych wersjach platformy, natomiast klasa v13 FragmentCompat zawiera shimy zgodności dla implementacji platformy klasy Fragment.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:support-v13:28.0.0

Biblioteka pomocy v14 Preference

Pakiet android.support.v14.preference udostępnia interfejsy API do dodawania obsługi 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 v14 Preference znajdziesz w pakiecie preference w dokumentacji API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:preference-v14:28.0.0

Biblioteka pomocy v17 Preference dla telewizora

Pakiet android.support.v17.preference udostępnia interfejsy API do udostępniania interfejsów preferencji na urządzeniach z Androidem TV, w tym obsługę interfejsu LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener oraz klas, takich jak BaseLeanbackPreferenceFragmenti LeanbackPreferenceFragment. Szczegółowe informacje o interfejsach API Biblioteki pomocy v17 Preference znajdziesz w pakiecie preference w dokumentacji API.

Ten pakiet wymaga poziomu API 17 lub wyższego. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

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

Biblioteka v17 Leanback

Pakiet android.support.v17.leanback udostępnia interfejsy API do tworzenia interfejsów użytkownika na urządzeniach z Androidem TV. Zawiera on wiele ważnych widżetów dla aplikacji na telewizory. Oto niektóre z najważniejszych klas:

Ten pakiet wymaga poziomu API 17 lub wyższego. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:leanback-v17:28.0.0

Biblioteka obiektów rysowalnych wektorowo

Obsługuje statyczną grafikę wektorową.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

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

Biblioteka animowanych obiektów rysowalnych wektorowo

Obsługuje animowaną grafikę wektorową.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

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

Biblioteka pomocy dotycząca adnotacji

Pakiet Annotation udostępnia interfejsy API do dodawania metadanych adnotacji do aplikacji.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:support-annotations:28.0.0

Biblioteka pomocy Design

Pakiet Design udostępnia interfejsy API do dodawania do aplikacji komponentów i wzorców Material Design.

Biblioteka pomocy Design dodaje obsługę różnych komponentów i wzorców Material Design, na których mogą bazować programiści aplikacji, takich jak szuflady nawigacyjne, pływające przyciski czynności (FAB), paski powiadomień i karty.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:design:28.0.0

Biblioteka pomocy dotycząca kart niestandardowych

Pakiet Custom Tabs udostępnia interfejsy API do dodawania kart niestandardowych do aplikacji i zarządzania nimi.

Biblioteka pomocy dotycząca kart niestandardowych dodaje obsługę różnych klas, takich jak usługa kart niestandardowych i wywołanie zwrotne kart niestandardowych.

Ten pakiet wymaga poziomu API 15 lub wyższego. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:customtabs:28.0.0

Biblioteka pomocy Percent

Pakiet Percent udostępnia interfejsy API do dodawania i zarządzania wymiarami opartymi na procentach w aplikacji.

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

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:percent:28.0.0

Biblioteka pomocy ExifInterface

Tagi Exif przechowują informacje takie jak orientacja, data i godzina, informacje o aparacie oraz lokalizacja bezpośrednio w pliku JPEG lub RAW. Klasa ExifInterface rozdziela obsługę odczytywania informacji Exif z plików w formatach JPEG i RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW i RAF) oraz ustawiania informacji Exif w plikach obrazów JPEG.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

com.android.support:exifinterface:28.0.0

Biblioteka pomocy dotycząca rekomendacji aplikacji na telewizor

Pakiet App Recommendation udostępnia interfejsy API do dodawania rekomendacji treści w aplikacji działającej na urządzeniach z Androidem TV.

Biblioteka App dodaje obsługę adnotacji, takich jak ContentRecommendation.ContentMaturity oraz różnych klas, takich jak ContentRecommendation i RecommendationExtender.

Ten pakiet wymaga poziomu API 21 lub wyższego. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:recommendation:28.0.0

Biblioteka Wear UI

Ta biblioteka zawiera interfejsy API do tworzenia interfejsów użytkownika dla aplikacji na Wear OS. Interfejsy API dostępne w pakiecie android.support.wear.widget zastępują odpowiednie interfejsy API w Bibliotece pomocy Wearable.

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki: 

com.android.support:wear:28.0.0