Pakiety bibliotek pomocy

Uwaga: w bibliotece pomocy w wersji 28.0.0 pakiet android.support zawiera biblioteki są wycofywane i zastępowane przez Jetpack z indywidualną wersją biblioteki spakowane jako androidx. Początkowa wersja 1.0.0 biblioteki Jetpack są zgodne z biblioteką pomocy technicznej 28.0.0 i zapewnia punkt początkowy migracji do nowej wersji androidx sposób prezentacji.

Istniejące biblioteki w pakiecie android.support będą nadal działać. jednak nie będą otrzymywać żadnych aktualizacji powyżej wersji 28.0.0 i nie będą zgodne z nowymi bibliotekami Jetpack. Artefakty historyczne (takie w wersji 27 lub starszej oraz spakowane jako android.support) będą nadal dostępne w Google Maven. Wszystkie nowe artefakty zostaną spakowane jako androidx i będzie wymagać migracji z android.support do androidx.

Zalecamy używanie bibliotek androidx we wszystkich nowych projektach. Wykonaj też rozważ migrację istniejących projektów, aby mieć pewność, aby 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. Postępuj zgodnie z instrukcjami pobierania bibliotek pomocy w Konfiguracja biblioteki pomocy – wykonaj tę czynność. 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

Te biblioteki zawierają największy zestaw interfejsów API w porównaniu z innymi bibliotekami Obejmuje to obsługę komponentów aplikacji, funkcji interfejsu ułatwienia dostępu, obsługa danych, połączenia sieciowe i programowanie i usług komunalnych.

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. Biblioteka została podzielona na wiele modułów, i zwiększanie wydajności. Aby zapewnić zgodność wsteczną, jeśli podasz support-v4 w skrypcie Gradle, aplikacja będzie zawierać wszystkie w modułach v4. Aby jednak zmniejszyć rozmiar aplikacji, wpisz tylko do konkretnych modułów potrzebnych przez aplikację.

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 bazowe 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

Dodano obsługę opisywania interfejsu i funkcji interfejsu za pomocą tagów fragmenty, co pozwala aplikacjom wyświetlać układy, które dostosowują się urządzeniach z dużym ekranem. Ten moduł wymaga zależności od interfejsów compat, core-utils, core-ui i media-compat.

Uwaga: biblioteka pomocy do wersji 13 udostępnia klasę FragmentCompat. 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 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. Dla: więcej informacji na temat korzystania z interfejsu Multidex można znaleźć w sekcji Tworzenie 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 uwzględnić w aplikacji niezależnie od siebie.

biblioteka appcompat w wersji 7 Zawiera Android Jetpack.

Uwaga: biblioteka appcompat została przeniesiona do biblioteki AndroidaX, czyli systemu Androida; Komponent Jetpack. Zobacz je w Słonecznik.

Ta biblioteka obsługuje Użytkownik paska działań projekt interfejsu Ta biblioteka obejmuje obsługę interfejs Material Design implementacji.

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 – zapewnia implementację paska działań wzorzec interfejsu. Więcej więcej informacji na temat korzystania z paska działań, zobacz Pasek działań – przewodnik dla programistów.
  • 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ę okna, która może być używana jako baza w przypadku dialogów o tematyce AppCompat.
  • ShareActionProvider – dodaje obsługę ustandaryzowanej, udostępniania (np. e-mail lub post w aplikacjach społecznościowych), które można umieścić w 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 CardView widżet, który pozwala wyświetlać informacje na kartach o spójnym wyglądzie w dowolnej aplikacji. Te karty są przydatne w przypadku interfejsu Material Design i są powszechnie stosowane w układach aplikacji telewizyjnych.

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, 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 MediaRouter, MediaRouteProvider i powiązane klasy multimedialne, 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 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 v7 znajdziesz android.support.v7.media pakiet w interfejsie API odwołania.

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 v7 wprowadzone w bibliotece pomocy r18 może ulec zmianie w późniejszych wersjach Biblioteki pomocy. W tym miejscu zalecamy korzystanie z niej tylko w połączeniu z Google Cast.

biblioteka palet v7

Biblioteka obsługi palety w wersji 7 zawiera Klasa Palette, która umożliwia wyodrębnianie istotne kolory 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 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 RecyclerView zajęcia. Te zajęcia pomagają w zakresie: Widok RecyclerView widżet, czyli widok do efektywnego wyświetlania dużych zbiorów danych, ograniczony okres ważności 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

preferencja pakiet udostępnia interfejsy API umożliwiające dodawanie obiektów preferencji, takich jak CheckBoxPreference i ListPreference, dla modyfikacji ustawień 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 zawiera określone zestawy funkcji i można ją uwzględnić w aplikacji niezależnie od innych bibliotek.

biblioteka renderscript v8

Ta biblioteka obsługuje obliczenia RenderScript platformy. Te interfejsy API znajdują się w pakiecie android.support.v8.renderscript. Ty że włączenie tych interfejsów API w aplikacji jest bardzo różni się od innych interfejsów API biblioteki pomocy. Więcej informacji o korzystaniu z tych interfejsów API w aplikacji zapoznaj się z Skrypt renderowania przewodnik dla programistów.

Uwaga: użycie języka RenderScript razem z biblioteką pomocy jest obsługiwane na urządzeniach z Androidem. Kompilacje oparte na 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

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 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 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 informacji o interfejsach API biblioteki pomocy w wersji v14 znajdziesz w preferencja w dokumentacji 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 wiele ważnych widżetów aplikacji TV. Oto niektóre z najciekawszych klas:

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:leanback-v17:28.0.0

Biblioteka rysowalna wektorowo

Zapewnia obsługę statycznej grafiki wektorowej.

Identyfikator zależności skryptu kompilacji Gradle w tej bibliotece to następujące:

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 tej bibliotece to następujące:

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 kompilacji Gradle w przypadku tej biblioteki wygląda tak:

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 kompilacji Gradle w przypadku tej biblioteki wygląda tak:

com.android.support:customtabs:28.0.0

Biblioteka pomocy Percent

Procent pakiet udostępnia interfejsy API umożliwiające dodawanie wartości procentowych i zarządzanie nimi wymiary w aplikacji.

Uwaga: od wersji 26.0.0 biblioteka Percent Support jest 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 pomocy Percent dodaje obsługę Interfejs PercentLayoutHelper.PercentLayoutParams i różnych klas, takich jak PercentFrameLayout oraz 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, 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 kompilacji Gradle w przypadku tej biblioteki wygląda tak: 

com.android.support:exifinterface:28.0.0

Biblioteka pomocy rekomendacji aplikacji na telewizory

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

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

com.android.support:wear:28.0.0