Pakiety bibliotek pomocy

Uwaga: wraz z wydaniem biblioteki pomocy w wersji 28.0.0 wycofujemy biblioteki w pakiecie android.support i zastępujemy je bibliotekami Jetpacka w pakiecie androidx. Pierwsza wersja bibliotek Jetpack w wersji 1.0.0 zapewnia zgodność z biblioteką Support Library w wersji 28.0.0 i stanowi punkt wyjścia do przeniesienia się na nowe opakowanie androidx.

Istniejące biblioteki w pakiecie android.support będą nadal działać, ale nie będą otrzymywać aktualizacji w wersji 28.0.0 ani nowszych i nie będą zgodne z nowymi bibliotekami Jetpacka. Historyczne artefakty (te w wersji 27 i wcześniejszych, zapakowane jako android.support) pozostaną dostępne w Google Maven. Wszystkie nowe artefakty będą pakowane jako androidx i będą wymagać przeniesienia z android.support do androidx.

Zalecamy używanie bibliotek androidx we wszystkich nowych projektach. Warto też przenieść istniejące projekty, 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 korzystać z którejkolwiek z tych bibliotek, musisz pobrać pliki bibliotek do instalacji pakietu Android SDK. Aby wykonać ten krok, postępuj zgodnie z instrukcjami dotyczącymi pobierania bibliotek pomocy podanymi w artykule Konfigurowanie bibliotek pomocy. Aby uwzględnić w aplikacji konkretną bibliotekę wsparcia, musisz wykonać dodatkowe czynności. Ważne informacje o włączaniu biblioteki w aplikacji znajdziesz na końcu każdej sekcji biblioteki.

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

Biblioteki pomocy w wersji 4

W porównaniu z innymi bibliotekami te biblioteki zawierają największą liczbę interfejsów API, w tym obsługę komponentów aplikacji, funkcji interfejsu użytkownika, ułatwień dostępu, obsługi danych, połączeń z siecią oraz narzędzi programistycznych.

Pełne i 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 wersją 24.2.0 biblioteki obsługi istniała jedna biblioteka obsługi wersji 4. Ta biblioteka została podzielona na kilka modułów w celu zwiększenia wydajności. Ze względu na zgodność wsteczną, jeśli w skrypcie Gradle podasz parametr support-v4, Twoja aplikacja będzie zawierać wszystkie moduły w wersji 4. Aby jednak zmniejszyć rozmiar aplikacji, zalecamy uwzględnienie tylko tych modułów, których potrzebuje Twoja aplikacja.

Biblioteka zgodna z wersją 4

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

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

com.android.support:support-compat:28.0.0

Biblioteka core-utils w wersji 4

Zawiera wiele klas pomocniczych, takich jak AsyncTaskLoader i PermissionChecker.

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

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

v4 core-ui library

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

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

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

Biblioteka zgodności z mediami w wersji 4

Wprowadziliśmy częściowe wsteczne porty ramówki dotyczące multimediów, w tym MediaBrowser i MediaSession.

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

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

Biblioteka fragmentów v4

Dodaje obsługę opakowania interfejsu użytkownika i funkcji za pomocą fragmentów, umożliwiając aplikacjom udostępnianie układów, które dostosowują się do małych i dużych ekranów. Ten moduł jest zależny od pakietów compat, core-utils, core-ui i media-compat.

Uwaga: biblioteka obsługi wersji 13 udostępnia klasę FragmentCompat. Klasa Fragment w wersji 4 jest samodzielną klasą, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, a klasa FragmentCompat w wersji 13 udostępnia elementy zapewniające zgodność z implementacją platformy dla klasy Fragment.

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

com.android.support:support-fragment:28.0.0

Biblioteka pomocy Multidex

Biblioteka ta obsługuje tworzenie aplikacji z większą liczbą plików Dalvik Executable (DEX). Aplikacje, które odwołują się do większej liczby niż 65 536 metod, muszą używać konfiguracji multidex. Więcej informacji o używaniu multideksów znajdziesz w artykule Tworzenie aplikacji z ponad 64 tys. metod.

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

com.android.support:multidex:1.0.0

Biblioteki pomocy w wersji 7

Te biblioteki udostępniają określone zestawy funkcji i mogą być uwzględniane w aplikacji niezależnie od siebie.

Biblioteka appcompat w wersji 7   Należy do Android Jetpack.

Uwaga: biblioteka appcompat została przeniesiona do biblioteki AndroidX, która jest komponentem Androida Jetpacka. Zobacz, jak działa w aplikacji demonstracyjnej Sunflower.

Biblioteka ta dodaje obsługę wzoru projektowania paska działań. Biblioteka ta obsługuje implementacje interfejsu użytkownika Material Design.

Uwaga: ta biblioteka zależy od biblioteki wsparcia w wersji 4.

Oto kilka najważniejszych klas dostępnych w bibliotece zgodności aplikacji w wersji 7:

  • ActionBar – implementacja wzorca interfejsu użytkownika paska działań. Więcej informacji o używaniu paska działań znajdziesz w przewodniku dla programistów Pasek działań.
  • AppCompatActivity – dodaje klasę aktywności aplikacji, która może służyć jako klasa podstawowa dla aktywności korzystających z implementacji paska czynności w bibliotece wsparcia.
  • AppCompatDialog – dodaje klasę dialogu, która może służyć jako klasa podstawowa do dialogów w motywie AppCompat.
  • ShareActionProvider – dodanie obsługi standardowego działania udostępniania (np. wysyłania e-maila lub publikowania w aplikacjach społecznościowych), które może być uwzględnione w pasku czynności.

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

com.android.support:appcompat-v7:28.0.0

Biblioteka widoku karty w wersji 7

Biblioteka ta dodaje obsługę widżetu CardView, który umożliwia wyświetlanie informacji w kartach o spójnym wyglądzie w dowolnej aplikacji. Karty te są przydatne w ramach implementacji Material Design i są szeroko wykorzystywane w schematach aplikacji na telewizory.

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

com.android.support:cardview-v7:28.0.0

Biblioteka układu siatki w wersji 7

Po pobraniu Bibliotek pomocy Androida biblioteka ta dodaje obsługę klasy GridLayout, która umożliwia układanie elementów interfejsu za pomocą siatki kwadratowych komórek. Szczegółowe informacje o interfejsach API biblioteki układu siatki w wersji 7 znajdziesz w pakiecie android.support.v7.widget w dokumentacji interfejsu API.

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

com.android.support:gridlayout-v7:28.0.0

Biblioteka mediarouter v7

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

Zasadniczo interfejsy API w bibliotece mediarouter w wersji 7 umożliwiają sterowanie kierowaniem kanałów i strumyków multimediów 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 ścieżek mediów w przypadku aplikacji, wykrywania i wybierania urządzeń docelowych oraz sprawdzania stanu multimediów. 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 Gradle dla tej biblioteki:

com.android.support:mediarouter-v7:28.0.0

Interfejsy API biblioteki mediarouter w wersji 7 wprowadzone w wersji 18 biblioteki Support Library mogą ulec zmianie w późniejszych wersjach tej biblioteki. Obecnie zalecamy używanie biblioteki tylko w związku z Google Cast.

biblioteka palety v7.

Biblioteka obsługi palety v7 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żyć obiektu Palette, aby wyodrębnić główne kolory z okładki albumu, a następnie użyć tych kolorów do stworzenia dopasowanej kolorystycznie karty tytułowej utworu.

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

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 do efektywnego wyświetlania dużych zbiorów danych przez udostępnianie ograniczonego okna elementów danych.

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

com.android.support:recyclerview-v7:28.0.0

Biblioteka pomocy preferencji w wersji 7

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

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 Gradle dla tej biblioteki:

com.android.support:preference-v7:28.0.0

Biblioteka pomocy v8

Ta biblioteka udostępnia określone zestawy funkcji i może być uwzględniona w aplikacji niezależnie od innych bibliotek.

Biblioteka renderscript v8

Ta biblioteka dodaje obsługę mechanizmu obliczeniowego RenderScript. Te interfejsy API są dostępne w pakiecie android.support.v8.renderscript. Pamiętaj, że dodanie tych interfejsów API do aplikacji znacznie różni się od dodawania innych interfejsów API biblioteki. Więcej informacji o używaniu tych interfejsów API w aplikacji znajdziesz w przewodniku dla deweloperów RenderScript.

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

Ten przykład pokazuje właściwości skryptu Gradle dla tej biblioteki:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Biblioteka pomocy w wersji 13

Ta biblioteka dodaje obsługę wzorca interfejsu użytkownika Fragment za pomocą klasy (FragmentCompat) i dodatkowych klas obsługujących fragmenty. Więcej informacji o fragmentach znajdziesz w przewodniku dla programistów. Szczegółowe informacje o interfejsach API biblioteki pomocy w wersji 13 znajdziesz w pakiecie android.support.v13 w dokumentacji interfejsu API.

Uwaga: biblioteka fragmentów w wersji 4 udostępnia klasę Fragment. Klasa Fragment w wersji 4 jest samodzielną klasą, która zawiera poprawki błędów dodane w późniejszych wersjach platformy, a klasa FragmentCompat w wersji 13 udostępnia elementy zapewniające zgodność z implementacją platformy dla klasy Fragment.

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

com.android.support:support-v13:28.0.0

Biblioteka pomocy v14

Pakiet android.support.v14.preference udostępnia interfejsy API do dodawania obsługi interfejsów preferencji, takich jak PreferenceFragment.OnPreferenceStartFragmentCallback i PreferenceFragment.OnPreferenceStartScreenCallback, oraz klasy takie jak MultiSelectListPreference i PreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki pomocy dotyczącej preferencji w wersji 14 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

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

com.android.support:preference-v14:28.0.0

Biblioteka pomocy dla Androida TV w wersji 17

Pakiet android.support.v17.preference udostępnia interfejsy API do obsługi 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 dotyczącej preferencji w wersji 17 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

Ten pakiet wymaga poziomu interfejsu API 17 lub nowszego. Identyfikator zależności skryptu Gradle dla tej biblioteki:

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

Biblioteka Leanback w wersji 17

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

Ten pakiet wymaga poziomu interfejsu API 17 lub nowszego. Identyfikator zależności skryptu Gradle dla tej biblioteki:

com.android.support:leanback-v17:28.0.0

Biblioteka obiektów rysowalnych wektorowo

Zapewnia obsługę statycznej grafiki wektorowej.

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

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

Biblioteka obiektów rysowalnych wektorowych z animowanymi elementami

Obsługuje animowaną grafikę wektorową.

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

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

Biblioteka pomocy dotycząca adnotacji

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

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

com.android.support:support-annotations:28.0.0

Biblioteka pomocy Design

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

Biblioteka Design Support umożliwia deweloperom aplikacji korzystanie z różnych komponentów i wzorców Material Design, takich jak panele nawigacyjne, przyciski akcji (FAB), paski narzędziowe i karty.

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

com.android.support:design:28.0.0

Biblioteka pomocy Tabli niestandardowych

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

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

Ten pakiet wymaga poziomu interfejsu API 15 lub nowszego. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki:

com.android.support:customtabs:28.0.0

Procent Biblioteki pomocy

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

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

Biblioteka Percent Support obsługuje interfejs PercentLayoutHelper.PercentLayoutParams oraz różne klasy, takie jak PercentFrameLayout i  PercentRelativeLayout.

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

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 udostępnia obsługę odczytu informacji Exif z plików w formacie JPEG oraz plików w formacie RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW i RAF) oraz ustawiania informacji Exif w plikach graficznych JPEG.

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

com.android.support:exifinterface:28.0.0

Biblioteka obsługi rekomendacji aplikacji na telewizor

Pakiet Rekomendacja aplikacji udostępnia interfejsy API do obsługi dodawania rekomendacji treści w aplikacji działającej na urządzeniach TV.

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

Ten pakiet wymaga poziomu API 21 lub nowszego. Identyfikator zależności skryptu Gradle dla tej biblioteki:

com.android.support:recommendation:28.0.0

Biblioteka Wear UI

Biblioteka ta zawiera interfejsy API do tworzenia interfejsów użytkownika aplikacji na Wear. Interfejsy API dostępne w pakiecie android.support.wear.widget zastępują odpowiadające im interfejsy API w bibliotece obsługi urządzeń noszonych.

Więcej informacji znajdziesz w  artykule o bibliotece interfejsu użytkownika Wear.

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

com.android.support:wear:28.0.0