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 zapewnia zgodność z biblioteką Support Library 28.0.0 i stanowi punkt wyjścia do przeniesienia się na nowe pakowanie androidx.

Istniejące biblioteki w pakiecie android.support będą nadal działać, ale nie będą otrzymywać aktualizacji w wersjach nowszych niż 28.0.0 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 w Twojej aplikacji. Każda z tych bibliotek obsługuje określony zakres platform Androida różne wersje i zestaw funkcji.

Aby korzystać z wymienionych niżej bibliotek, musisz pobrać pliki biblioteki Instalacja pakietu SDK na Androida. Aby wykonać ten krok, postępuj zgodnie z instrukcjami dotyczącymi pobierania bibliotek pomocy podanymi w artykule Konfigurowanie bibliotek pomocy. Musisz wykonać dodatkowe czynności, aby dołączyć określoną bibliotekę pomocy do Twojej aplikacji. Na końcu każdej z sekcji dotyczących bibliotek poniżej znajdziesz ważne informacje o tym, jak dodać bibliotekę do aplikacji.

Uwaga: minimalna wersja pakietu SDK do obsługi wszystkich elementów. pakiety bibliotek mają co najmniej poziom 14. Niektóre pakiety wymagają wyższego interfejsu API jak zaznaczono poniżej.

Biblioteki pomocy technicznej 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 dostarczanych przez biblioteki pomocy V4 znajdziesz w pakiecie android.support.v4 w dokumentacji interfejsu API.

Uwaga: przed wprowadzeniem Biblioteki pomocy w wersji 24.2.0 do tej pory dostępny był pojedyncza biblioteka pomocy w wersji 4. Ta biblioteka została podzielona na kilka modułów w celu zwiększenia wydajności. Aby zapewnić zgodność wsteczną, jeśli wymienisz support-v4 w skrypcie Gradle, aplikacja będzie zawierać wszystkie w modułach v4. Aby jednak zmniejszyć rozmiar aplikacji, zalecamy uwzględnienie tylko tych modułów, których potrzebuje Twoja aplikacja.

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 core-utils w wersji 4

Udostępnia wiele klas narzędzi, takich jak AsyncTaskLoader i PermissionChecker.

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

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

v4 core-ui library

Implementuje 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 zgodna z multimediami 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 w przypadku tej biblioteki wygląda tak: 

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 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 używaniu multideksów znajdziesz w artykule Tworzenie aplikacji z ponad 64 tys. metod.

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

com.android.support:multidex:1.0.0

Biblioteki pomocy technicznej v7

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

biblioteka appcompat w wersji 7 Zawiera 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ń. Ta biblioteka obejmuje obsługę interfejs Material Design implementacji.

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

Oto kilka najważniejszych klas zawartych w bibliotece kompatybilności aplikacji w wersji 7:

  • ActionBar – zapewnia implementację paska działań wzorzec interfejsu. 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 jest używana jako klasa bazowa w przypadku działań wykonywanych na pasku działań Biblioteki pomocy. implementacji.
  • 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

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. Karty te są przydatne w ramach implementacji Material Design i są szeroko wykorzystywane w układach aplikacji na telewizory.

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

com.android.support:cardview-v7:28.0.0

biblioteka układów siatki w wersji 7

Gdy pobierzesz biblioteki pomocy Androida, będzie ona obsługiwać GridLayout zajęcia, które 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 android.support.v7.widget w dokumentacji 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 klasy MediaRouter, MediaRouteProvider i powiązane klasy multimediów, które obsługują Google Cast.

Ogólnie interfejsy API w bibliotece mediaroutera v7 umożliwiają sterowanie kierowaniem kanałów multimedialnych i strumieni z bieżącego urządzenia do zewnętrzne ekrany, głośniki i inne urządzenia docelowe. Biblioteka obejmuje Interfejsy API do publikowania dostawców tras multimediów dla konkretnych aplikacji w celu wykrywania wybieranie urządzeń docelowych, sprawdzanie stanu multimediów itp. Szczegółowe informacje o interfejsach API biblioteki mediarouter w wersji 7 znajdziesz w pakiecie android.support.v7.media w dokumentacji interfejsów 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. W tym miejscu zalecamy korzystanie z niej tylko w połączeniu 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ć Palette obiekt do wyodrębnienia kolorów głównych z okładki albumu i wykorzystać te kolory, aby utworzyć utwór kartę tytułową.

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 RecyclerView zajęcia. 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 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: Preference.OnPreferenceChangeListener i Preference.OnPreferenceClickListener i zajęcia, na przykład 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ż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 korzystaniu z tych interfejsów API w aplikacji zapoznaj się z Skrypt renderowania przewodnik dla programistów.

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

Obsługa w tej bibliotece dla wzorca interfejsu Fragment z klasą (FragmentCompat) i dodatkową obsługą fragmentów zajęcia. Więcej informacji o fragmentach znajdziesz tutaj: Fragmenty – przewodnik dla programistów. Szczegółowe informacje informacje o interfejsach API biblioteki pomocy w wersji 13 znajdziesz w pakiecie android.support.v13 w dokumentacji API.

Uwaga: biblioteka z fragmentami w wersji 4 udostępnia klasę Fragment. Wersja 4 Fragment zajęcia to samodzielne zajęcia, które zapewnia poprawki błędów, które zostały dodane w późniejszych wersjach platformy, Klasa FragmentCompat w wersji 13 udostępnia podkładki kompatybilne dla platformy implementacji Fragment zajęcia.

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

com.android.support:support-v13:28.0.0

Biblioteka obsługi preferencji wersji 14

Pakiet android.support.v14.preference zawiera interfejsy API umożliwiające obsługę dla interfejsów preferencji, takich jak PreferenceFragment.OnPreferenceStartFragmentCallback oraz PreferenceFragment.OnPreferenceStartScreenCallback wraz z klasami, takimi 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 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 określenie preferencji z interfejsami na telewizorach, w tym obsługę LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener interfejsów i klas, takich jak BaseLeanbackPreferenceFragment i LeanbackPreferenceFragment Szczegółowe informacje informacji o interfejsach API biblioteki pomocy Preference Library (wersja 17) znajdziesz w preferencja w dokumentacji API.

Ten pakiet wymaga interfejsu API na poziomie 17 lub wyższym. Skrypt kompilacji Gradle identyfikator zależności dla tej biblioteki 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 obsługują tworzenie interfejsów użytkownika na telewizorach. Zawiera ona wiele ważnych widżetów dla aplikacji na telewizory. Oto niektóre z najciekawszych klas:

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 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 obsługi adnotacji

Adnotacja pakiet udostępnia interfejsy API umożliwiające dodawanie metadanych adnotacji do aplikacji.

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

com.android.support:support-annotations:28.0.0

Biblioteka wsparcia dla projektów

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

Biblioteka Design Support zapewnia obsługę różnych komponentów i wzorców Material Design dla deweloperów aplikacji, na których mogą opierać się np. 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

Karty niestandardowe Ten pakiet udostępnia interfejsy API, które umożliwiają dodawanie niestandardowych kart i zarządzanie nimi w aplikacjach.

Biblioteka Obsługa kart niestandardowych zapewnia obsługę różnych klas, takich jak: Karty niestandardowe Usługa oraz Karty niestandardowe Oddzwanianie.

Ten pakiet wymaga interfejsu API na poziomie 15 lub wyższym. Identyfikator zależności skryptu 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 procentach 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 nową wersję ConstraintLayout widżet, który jest udostępniany jako oddzielny artefakt w usłudze SDK Manager.

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, aparat oraz lokalizację bezpośrednio w pliku JPEG lub RAW. ExifInterface klasa wyodrębnia obsługę odczytu informacji Exif z JPEG i nieprzetworzone (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW i RAF) oraz Ustawianie informacji Exif dla plików 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

Kampanie promujące aplikacje Rekomendacja Ten pakiet 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: Rekomendacje treści oraz Rozszerzenie rekomendacji.

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 Wear UI

Ta biblioteka zawiera interfejsy API do tworzenia interfejsów użytkownika aplikacji na Wear. Interfejsy API dostępne w pakietu android.support.wear.Widget, zastąp odpowiednie interfejsy API w bibliotece pomocy dotyczącej urządzeń do noszenia.

Więcej informacji: Za pomocą biblioteki interfejsu Wear.

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

com.android.support:wear:28.0.0