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 wersjach indywidualnych, które są pakowane jako androidx. Pierwsza wersja bibliotek Jetpack 1.0.0 jest zgodna z wersją Support Library 28.0.0 i stanowi punkt wyjścia do przeniesienia się na nowe pakowanie 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 (te w wersji 27 i wcześniejszych, zapakowane 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ż przeniesienie 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żna uwzględnić w aplikacji. Każda z tych bibliotek obsługuje określony zakres wersji platformy Androida i zestawu 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.

Uwaga: minimalna wersja pakietu SDK dla wszystkich pakietów bibliotek obsługiwanych przez system 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, 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. 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. Jednak aby 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 kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:support-compat:28.0.0

Biblioteka core-utils w wersji 4

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

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

Identyfikator zależności skryptu 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 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ł wymaga zależności od interfejsó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 Gradle dla tej biblioteki: 

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 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 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   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 z wersją 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ó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 układach aplikacji na telewizory.

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

com.android.support:cardview-v7:28.0.0

Biblioteka układu 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 Gradle dla tej biblioteki:

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.

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 multimedialnych dla 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 opisie pakietu android.support.v7.media w dokumentacji 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 bibliotece pomocy r18 mogą ulec zmianie w późniejszych wersjach biblioteki pomocy. Obecnie zalecamy korzystanie z biblioteki tylko w związku z Google Cast.

biblioteka palety w wersji 7.

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

com.android.support:recyclerview-v7:28.0.0

Biblioteka obsługi preferencji 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ę platformy obliczeniowej 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 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/.

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 interfejsów 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 zawiera 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 obsługi preferencji w wersji 14 znajdziesz w pakiecie preference w dokumentacji interfejsu API.

Identyfikator zależności skryptu kompilacji 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 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 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 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 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 rysowalna 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 rysowalna z animowanymi wektorami

Obsługuje animowaną grafikę wektorową.

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

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:

com.android.support:support-annotations:28.0.0

Biblioteka pomocy Design

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

com.android.support:design:28.0.0

Biblioteka pomocy kart 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 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 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 dodaje obsługę interfejsu PercentLayoutHelper.PercentLayoutParams oraz 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 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 App Recommendation udostępnia interfejsy API, które ułatwiają dodawanie rekomendacji treści w aplikacjach działających na urządzeniach telewizyjnych.

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

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

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ą odpowiednie interfejsy API w bibliotece pomocy dotyczącej urządzeń do noszenia.

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