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:
BrowseFragment
– fragment służący do tworzenia układu podstawowego do przeglądania kategorii i wierszy elementów multimedialnych.DetailsFragment
– fragment kodu dla ekranów szczegółów Leanback.PlaybackOverlayFragment
– podklasa klasyDetailsFragment
do wyświetlania elementów sterujących odtwarzaniem i powiązanych treści.SearchFragment
– fragment do obsługi wyszukiwań. Fragment otrzymuje żądanie wyszukiwania użytkownika i przekazuje je do dostarczonego przez aplikacjęSearchResultProvider
.SearchResultProvider
zwraca wyniki wyszukiwania doSearchFragment
, co renderuje je wRowsFragment
.
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