Pakiety bibliotek pomocy

Uwaga: wraz z udostępnieniem biblioteki pomocy w wersji 28.0.0 biblioteki w pakiecie android.support zostały wycofane i zastąpione bibliotekami Jetpack w wersjach indywidualnych, które są pakowane jako androidx. Pierwsza wersja 1.0.0 bibliotek Jetpack jest równoważna z biblioteką pomocy w wersji 28.0.0 i stanowi punkt wyjścia do migracji do nowego androidxpakietu.

Istniejące biblioteki w pakiecie android.support będą nadal działać, ale nie będą otrzymywać aktualizacji po wersji 28.0.0 i nie będą zgodne z nowymi bibliotekami Jetpack. Artefakty historyczne (wersje 27 i starsze, spakowane jako android.support) pozostaną dostępne w Google Maven. Wszystkie nowe artefakty będą pakowane jako androidx i będą wymagać migracji z android.support na androidx.

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

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 używać którejkolwiek z tych bibliotek, musisz pobrać pliki biblioteki do instalacji pakietu SDK na Androida. Aby wykonać ten krok, postępuj zgodnie z instrukcjami pobierania bibliotek pomocy podanymi w artykule Konfigurowanie bibliotek pomocy. Aby uwzględnić w aplikacji konkretną bibliotekę pomocy, musisz wykonać dodatkowe czynności. Na końcu każdej sekcji biblioteki znajdziesz ważne informacje o tym, jak uwzględnić bibliotekę w aplikacji.

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

Biblioteki pomocy v4

Biblioteki te 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 w wersji 4 znajdziesz w pakiecie android.support.v4 w dokumentacji interfejsu API.

Uwaga: przed wprowadzeniem wersji 24.2.0 biblioteki pomocy istniała tylko jedna biblioteka pomocy v4. Biblioteka została podzielona na kilka modułów, aby zwiększyć wydajność. Aby zachować zgodność wsteczną, jeśli w skrypcie Gradle umieścisz support-v4, aplikacja będzie zawierać wszystkie moduły v4. Aby jednak zmniejszyć rozmiar aplikacji, zalecamy podanie tylko tych modułów, których potrzebuje Twoja aplikacja.

Biblioteka zgodności v4

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 następujący:

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 następujący: 

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

biblioteka v4 core-ui

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący: 

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

biblioteka v4 media-compat

Przenosi części platformy media, w tym MediaBrowser i MediaSession.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący: 

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

Biblioteka fragmentów v4

Dodaje obsługę hermetyzacji interfejsu użytkownika i funkcjonalności za pomocą fragmentów, co umożliwia aplikacjom dostarczanie układów, które dostosowują się do urządzeń z małym i dużym ekranem. Ten moduł jest zależny od modułów compat, core-utils, core-ui i media-compat.

Uwaga: biblioteka pomocy v13 udostępnia klasę FragmentCompat. Klasa v4 Fragment to klasa samodzielna, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, natomiast klasa v13 FragmentCompat zapewnia warstwy zgodności dla implementacji klasy Fragment w ramach platformy.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący: 

com.android.support:support-fragment:28.0.0

Biblioteka pomocy multidex

Ta biblioteka umożliwia tworzenie aplikacji z wieloma plikami wykonywalnymi Dalvik (DEX). Aplikacje, które odwołują się do ponad 65 536 metod, muszą używać konfiguracji multidex. Więcej informacji o używaniu multidexu znajdziesz w artykule Tworzenie aplikacji z ponad 64 tys. metod.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący: 

com.android.support:multidex:1.0.0

Biblioteki pomocy v7

Te biblioteki udostępniają określone zestawy funkcji i można je uwzględniać 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 Androida Jetpack. Zobacz, jak działa w aplikacji demonstracyjnej Sunflower.

Ta biblioteka dodaje obsługę interfejsu użytkownika paska działań, który jest wzorcem projektu. Ta biblioteka obsługuje implementacje interfejsu użytkownika Material Design.

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

Oto kilka najważniejszych klas w bibliotece appcompat w wersji 7:

  • ActionBar – udostępnia implementację paska działań, który jest wzorcem interfejsu. Więcej informacji o korzystaniu z paska działań znajdziesz w przewodniku dla programistów Pasek 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, która może być używana jako klasa bazowa okien z motywem AppCompat.
  • ShareActionProvider – dodaje obsługę standardowego działania udostępniania (np. e-maila lub publikowania w aplikacjach społecznościowych), które można umieścić na pasku działań.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:appcompat-v7:28.0.0

Biblioteka widoku karty w wersji 7

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:cardview-v7:28.0.0

Biblioteka gridlayout v7

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 gridlayout w wersji 7 znajdziesz w pakiecie android.support.v7.widget w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:gridlayout-v7:28.0.0

Biblioteka mediarouter w wersji 7

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

Ogólnie rzecz biorąc, interfejsy API w bibliotece mediarouter w wersji 7 umożliwiają sterowanie routingiem kanałów i strumieni multimedialnych z bieżącego urządzenia na zewnętrzne ekrany, głośniki i inne urządzenia docelowe. Biblioteka zawiera interfejsy API do publikowania dostawców tras multimediów 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 mediarouter w wersji 7 znajdziesz w pakiecie android.support.v7.media w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:mediarouter-v7:28.0.0

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

Biblioteka palet v7

Biblioteka obsługi palety v7 zawiera klasę Palette, która umożliwia wyodrębnianie dominujących kolorów z obrazu. Na przykład aplikacja muzyczna może użyć obiektu Palette, aby wyodrębnić główne kolory z okładki albumu i użyć ich do utworzenia karty z tytułem utworu w dopasowanych kolorach.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:palette-v7:28.0.0

Biblioteka recyclerview w wersji 7

Biblioteka recyclerview dodaje klasę RecyclerView. Ta klasa obsługuje widżet RecyclerView, czyli widok, który umożliwia wydajne wyświetlanie dużych zbiorów danych poprzez udostępnianie ograniczonego okna elementów danych.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:recyclerview-v7:28.0.0

Biblioteka pomocy dotycząca ustawień v7

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

Biblioteka preferencji w wersji 7 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 następujący:

com.android.support:preference-v7:28.0.0

Biblioteka pomocy v8

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

Biblioteka renderscript w wersji 8

Ta biblioteka dodaje obsługę platformy obliczeniowej RenderScript. Te interfejsy API są zawarte w pakiecie android.support.v8.renderscript. Pamiętaj, że kroki, które musisz wykonać, aby uwzględnić te interfejsy 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 deweloperów RenderScript.

Uwaga: korzystanie z RenderScriptu z biblioteką pomocy jest obsługiwane w Androidzie Studio i w kompilacjach opartych na Gradle. Biblioteka RenderScript znajduje się w folderze build-tools/$VERSION/renderscript/.

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Biblioteka pomocy w wersji 13

Ta biblioteka dodaje obsługę wzorca interfejsu Fragment za pomocą klasy (FragmentCompat) i dodatkowych klas obsługi fragmentów. Więcej informacji o fragmentach znajdziesz w przewodniku dla programistów Fragmenty. Szczegółowe informacje o interfejsach API biblioteki pomocy w wersji 13 znajdziesz w pakiecie android.support.v13 w materiałach referencyjnych interfejsu API.

Uwaga: biblioteka fragmentów v4 udostępnia klasę Fragment. Klasa v4 Fragment to klasa samodzielna, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, natomiast klasa v13 FragmentCompat zapewnia warstwy zgodności dla implementacji klasy Fragment w ramach platformy.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:support-v13:28.0.0

Biblioteka pomocy dotycząca ustawień w wersji 14

Pakiet android.support.v14.preference udostępnia interfejsy API, które umożliwiają dodawanie 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 dotyczącej ustawień w wersji 14 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:preference-v14:28.0.0

Biblioteka pomocy v17 dotycząca ustawień na telewizor

Pakiet android.support.v17.preference udostępnia interfejsy API do wyświetlania interfejsów preferencji na urządzeniach TV, w tym obsługę interfejsu LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener i klas, takich jak BaseLeanbackPreferenceFragment i LeanbackPreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki pomocy dotyczącej ustawień w wersji 17 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

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

 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 pomagają tworzyć interfejsy użytkownika na telewizorach. Zawiera ona wiele ważnych widżetów dla aplikacji na telewizory. Oto niektóre z najważniejszych zajęć:

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

com.android.support:leanback-v17:28.0.0

Biblioteka obiektów rysowalnych wektorowo

Obsługuje statyczne grafiki wektorowe.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

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

Biblioteka animowanych obiektów rysowalnych wektorowo

Zapewnia obsługę animowanej grafiki wektorowej.

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

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

Biblioteka pomocy dotycząca adnotacji

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:support-annotations:28.0.0

Biblioteka pomocy dotycząca projektowania

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

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:design:28.0.0

Biblioteka pomocy kart niestandardowych

Pakiet kart niestandardowych udostępnia interfejsy API, które umożliwiają dodawanie kart niestandardowych do aplikacji i zarządzanie nimi.

Biblioteka obsługi kart niestandardowych dodaje obsługę różnych klas, takich jak Custom Tabs Service i Custom Tabs Callback.

Ten pakiet wymaga API na poziomie 15 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:customtabs:28.0.0

Biblioteka pomocy procentowej

Pakiet Percent udostępnia interfejsy API, które umożliwiają dodawanie wymiarów opartych na procentach i zarządzanie nimi w aplikacji.

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

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący:

com.android.support:percent:28.0.0

Biblioteka pomocy ExifInterface

Tagi EXIF przechowują informacje takie jak orientacja, data i godzina, informacje o aparacie i 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 następujący: 

com.android.support:exifinterface:28.0.0

Biblioteka pomocy dotycząca rekomendacji aplikacji na telewizor

Pakiet App Recommendation zawiera interfejsy API, które umożliwiają dodawanie rekomendacji treści w aplikacji działającej na urządzeniach TV.

Biblioteka aplikacji 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 następujący:

com.android.support:recommendation:28.0.0

biblioteka Wear UI

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 Wearable Support Library.

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

Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest następujący: 

com.android.support:wear:28.0.0