Pakiety bibliotek pomocy

Uwaga: w wersji 28.0.0 biblioteki pomocy technicznej w wersji 28.0.0 biblioteki w pakiecie android.support zostały wycofane i zastąpione bibliotekami Jetpack w pakiecie androidx. Wstępna wersja 1.0.0 bibliotek Jetpack zapewnia zgodność z biblioteką pomocy w wersji 28.0.0 i stanowi punkt wyjścia do migracji do nowego pakietu androidx.

Istniejące biblioteki w pakiecie android.support będą nadal działać, ale nie będą otrzymywać żadnych aktualizacji po wersji 28.0.0 i nie będą zgodne z nowymi bibliotekami Jetpack. Historyczne artefakty (w wersji 27 i starszych i spakowane jako android.support) pozostaną dostępne w Google Maven. Wszystkie nowe artefakty zostaną spakowane jako androidx i będą wymagać migracji z android.support do androidx.

Zalecamy używanie bibliotek androidx we wszystkich nowych projektach. Zastanów się też nad przeniesieniem 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żesz umieścić w swojej aplikacji. Każda z tych bibliotek obsługuje określony zakres wersji platformy Androida i zestaw funkcji.

Aby korzystać z wymienionych poniżej bibliotek, musisz pobrać pliki bibliotek do instalacji pakietu Android SDK. Aby ukończyć ten krok, postępuj zgodnie z instrukcjami pobierania bibliotek pomocy podanymi w sekcji Konfiguracja biblioteki pomocy. Aby dodać konkretną bibliotekę pomocy, do swojej aplikacji musisz wykonać dodatkowe czynności. Na końcu każdej sekcji biblioteki znajdziesz ważne informacje o tym, jak dodać ją do aplikacji.

Uwaga: minimalna wersja SDK dla wszystkich pakietów bibliotecznych pomocy to co najmniej API na poziomie 14. Niektóre pakiety wymagają wyższego poziomu interfejsu API, jak pokazano poniżej.

Biblioteki pomocy (wersja 4)

Te biblioteki obejmują największy zestaw interfejsów API w porównaniu do innych bibliotek, w tym obsługę komponentów aplikacji, funkcji interfejsu użytkownika, ułatwień dostępu, obsługi danych, połączeń sieciowych i narzędzi programistycznych.

Szczegółowe informacje o klasach i metodach dostępnych w bibliotekach pomocniczych w wersji 4 znajdziesz w dokumentacji pakietu android.support.v4 w dokumentacji interfejsu API.

Uwaga: przed wersją 24.2.0 Biblioteki pomocy istniała 1 biblioteka pomocy w wersji 4. Biblioteka została podzielona na kilka modułów, co pozwoliło zwiększyć wydajność. Jeśli w skrypcie Gradle podasz support-v4, aplikacja będzie zawierać wszystkie moduły wersji 4, aby zapewnić zgodność wsteczną. Jednak aby zmniejszyć rozmiar aplikacji, zalecamy podanie tylko tych modułów, których potrzebuje Twoja aplikacja.

biblioteka compat

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

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

com.android.support:support-compat:28.0.0

biblioteka podstawowych narzędzi v4

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

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

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

biblioteka podstawowego interfejsu użytkownika wersji 4

Stosuje różne komponenty związane z interfejsem, np. ViewPager, NestedScrollView lub ExploreByTouchHelper.

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

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

biblioteka Media-compat wersja 4

Fragmenty backendu platformy media, w tym MediaBrowser i MediaSession.

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

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

Biblioteka fragmentów w wersji 4

Dodano obsługę herbaty interfejsu i funkcji za pomocą fragmentów, dzięki czemu aplikacje mogą udostępniać układy, które dostosowują się do małych i dużych ekranów. Ten moduł zależy od tych interfejsów: compat, core-utils, core-ui i media-compat.

Uwaga: biblioteka pomocy w wersji 13 zawiera klasę FragmentCompat. Klasa Fragment w wersji 4 jest samodzielną klasą, która zawiera poprawki błędów dodane w nowszych wersjach platformy. Klasa FragmentCompat w wersji 13 zawiera podkładki zgodności na potrzeby implementacji platformy Fragment.

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

com.android.support:support-fragment:28.0.0

Biblioteka obsługi Multidex

Ta biblioteka umożliwia tworzenie aplikacji przy użyciu wielu plików Dalvik Executable (DEX). Do korzystania z konfiguracji multidex wymagane są aplikacje, które odwołują się do ponad 65 536 metod. Więcej informacji o korzystaniu z multidex znajdziesz w artykule na temat tworzenia aplikacji przy użyciu ponad 64 tys. metod.

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

com.android.support:multidex:1.0.0

Biblioteki pomocy dla wersji 7

Biblioteki te udostępniają określone zestawy funkcji i można je dołączyć do aplikacji niezależnie od siebie.

Biblioteka appcompat w wersji 7 Część stanowiąca część Androida Jetpack.

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

Ta biblioteka dodaje obsługę wzorca wyglądu interfejsu użytkownika paska działań. Ta biblioteka obejmuje obsługę implementacji interfejsu Material Design.

Uwaga: ta biblioteka korzysta z biblioteki pomocy technicznej w wersji 4.

Oto kilka z klas kluczowych dostępnych w bibliotece appcompat w wersji 7:

  • ActionBar – udostępnia implementację wzorca interfejsu paska działań. Więcej informacji o korzystaniu z paska działań znajdziesz w przewodniku dla programistów dotyczącym paska działań.
  • AppCompatActivity – dodaje klasę aktywności aplikacji, której można używać jako klasy podstawowej dla działań korzystających z implementacji paska działań biblioteki pomocy.
  • AppCompatDialog – dodaje klasę okna dialogowego, której można używać jako klasy podstawowej dla okien dialogowych związanych z AppCompat.
  • ShareActionProvider – dodaje obsługę ustandaryzowanych działań związanych z udostępnianiem (takich jak wysyłanie e-maili lub publikowanie 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 taki:

com.android.support:appcompat-v7:28.0.0

biblioteka widoku kart v7

Ta biblioteka dodaje obsługę widżetu CardView, który umożliwia wyświetlanie informacji wewnątrz kart, które mają spójny wygląd w dowolnej aplikacji. Karty te przydają się w implementacjach interfejsu Material Design i są często stosowane w układach aplikacji na telewizory.

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

com.android.support:cardview-v7:28.0.0

Biblioteka układu siatki w wersji 7

Po pobraniu bibliotek pomocy Androida ta biblioteka dodaje obsługę klasy GridLayout, co umożliwia rozmieszczanie elementów interfejsu za pomocą siatki prostokątnych komórek. Szczegółowe informacje o interfejsach API biblioteki układu siatki w wersji 7 znajdziesz w dokumentacji pakietu android.support.v7.widget w dokumentacji API.

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

com.android.support:gridlayout-v7:28.0.0

Biblioteka Mediarouter w wersji 7

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

Ogólnie interfejsy API w bibliotece mediarouter w wersji 7 umożliwiają sterowanie routingiem kanałów multimedialnych i strumieni 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 tras multimediów specyficznych dla aplikacji, wykrywania i wybierania urządzeń docelowych, sprawdzania stanu multimediów itp. Szczegółowe informacje o interfejsach API biblioteki mediarouter w wersji 7 znajdziesz w dokumentacji pakietu android.support.v7.media w dokumentacji API.

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

com.android.support:mediarouter-v7:28.0.0

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

Biblioteka palet v7

Biblioteka obsługi palet v7 zawiera klasę Palette, która umożliwia wyodrębnianie wyraźnych kolorów z obrazu. Aplikacja muzyczna może na przykład użyć obiektu Palette, aby wyodrębnić główne kolory z okładki albumu, a następnie użyć ich do utworzenia karty tytułowej utworu, której kolory są koordynowane.

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

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 pozwalający na efektywne wyświetlanie dużych zbiorów danych przez zapewnienie ograniczonego okna elementów danych.

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

com.android.support:recyclerview-v7:28.0.0

Biblioteka pomocy preferencji w wersji 7

Pakiet preference zawiera interfejsy API umożliwiające dodawanie obiektów preferencji, takich jak CheckBoxPreference i ListPreference, które umożliwiają użytkownikom modyfikowanie ustawień 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 taki:

com.android.support:preference-v7:28.0.0

Biblioteka pomocy wersji 8

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

Biblioteka renderowania v8

Ta biblioteka dodaje obsługę platformy obliczeniowej RenderScript. Te interfejsy API wchodzą w skład pakietu android.support.v8.renderscript. Pamiętaj, że czynności, które musisz wykonać, aby włączyć te interfejsy API do swojej aplikacji, bardzo się różnią od czynności wykonywanych w innych interfejsach API bibliotek pomocniczych. 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 w połączeniu z biblioteką pomocy jest obsługiwane w przypadku kompilacji opartych na Androidzie Studio i Gradle. Biblioteka renderowania znajduje się w folderze build-tools/$VERSION/renderscript/.

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Biblioteka pomocy dotycząca wersji 13

Ta biblioteka dodaje obsługę wzorca interfejsu Fragment z klasą (FragmentCompat) i dodatkowe klasy obsługi fragmentów. Więcej informacji na temat fragmentów znajdziesz w przewodniku dla programistów dotyczącym fragmentów. Szczegółowe informacje o interfejsach API biblioteki pomocy w wersji 13 znajdziesz w opisie pakietu android.support.v13 w dokumentacji interfejsów API.

Uwaga: biblioteka fragmentów w wersji 4 zawiera klasę Fragment. Klasa Fragment w wersji 4 jest samodzielną klasą, która zawiera poprawki błędów dodane w nowszych wersjach platformy. Klasa FragmentCompat w wersji 13 zawiera podkładki zgodności na potrzeby implementacji platformy Fragment.

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

com.android.support:support-v13:28.0.0

Biblioteka pomocy preferencji w wersji 14

Pakiet android.support.v14.preference zawiera interfejsy API umożliwiające obsługę interfejsów preferencji, takich jak PreferenceFragment.OnPreferenceStartFragmentCallback i PreferenceFragment.OnPreferenceStartScreenCallback, a także klas, takich jak MultiSelectListPreference i PreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki obsługi preferencji w wersji 14 znajdziesz w pakiecie preference w dokumentacji interfejsów API.

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

com.android.support:preference-v14:28.0.0

Biblioteka pomocy preferencji w wersji 17 na telewizory

Pakiet android.support.v17.preference zawiera interfejsy API umożliwiające zapewnienie preferowanych interfejsów na urządzeniach telewizyjnych, w tym obsługę interfejsu i klas LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener, takich jak BaseLeanbackPreferenceFragment i LeanbackPreferenceFragment. Szczegółowe informacje o interfejsach API biblioteki obsługi preferencji w wersji 17 znajdziesz w pakiecie preference w dokumentacji interfejsów API.

Ten pakiet wymaga interfejsu API na poziomie 17 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

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

Biblioteka funkcji TalkBack w wersji 17

Pakiet android.support.v17.leanback zawiera interfejsy API umożliwiające tworzenie interfejsów użytkownika na telewizorach. Zawiera wiele ważnych widżetów dla aplikacji telewizyjnych. Do godnych uwagi należą:

Ten pakiet wymaga interfejsu API na poziomie 17 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:leanback-v17:28.0.0

Biblioteka rysowalna wektorowo

Zapewnia obsługę statycznej grafiki wektorowej.

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

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

Animowana biblioteka rysowalnych wektorów

Zapewnia obsługę animowanej grafiki wektorowej.

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

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

Biblioteka obsługi adnotacji

Pakiet adnotacji zawiera interfejsy API umożliwiające dodawanie metadanych adnotacji do aplikacji.

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

com.android.support:support-annotations:28.0.0

Biblioteka pomocy przy projektowaniu

Pakiet design zawiera interfejsy API umożliwiające dodawanie do aplikacji komponentów i wzorców Material Design.

Biblioteka pomocy w projektowaniu dodaje obsługę różnych komponentów i wzorców Material Design, na których mogą się opierać, takich jak szuflady nawigacji, pływające przyciski poleceń (FAB), paski powiadomień i karty.

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

com.android.support:design:28.0.0

Biblioteka obsługi kart niestandardowych

Pakiet kart niestandardowych zawiera interfejsy API, które ułatwiają dodawanie kart niestandardowych i zarządzanie nimi w aplikacjach.

Biblioteka obsługi kart niestandardowych dodaje obsługę różnych klas, takich jak usługa kart niestandardowych i wywołanie zwrotne kart niestandardowych.

Ten pakiet wymaga interfejsu API na poziomie 15 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:customtabs:28.0.0

Biblioteka pomocy procentowej

Pakiet Percent zawiera interfejsy API umożliwiające dodawanie do aplikacji wymiarów opartych na wartościach procentowych i zarządzanie nimi.

Uwaga: w wersji 26.0.0 biblioteka Percent Support została wycofana. Klienci tego modułu powinni przejść na nowy widżet ConstraintLayout, który jest dostępny jako oddzielny artefakt w usłudze SDK Manager.

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

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

com.android.support:percent:28.0.0

Biblioteka pomocy ExifInterface

Tagi Exif przechowują takie informacje jak orientacja, data i godzina, informacje o aparacie oraz lokalizacja bezpośrednio w pliku JPEG lub RAW. Klasa ExifInterface wyodrębnia obsługę odczytu danych Exif z plików JPEG i nieprzetworzonych (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW i RAF) oraz ustawiania informacji Exif w plikach graficznych JPEG.

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

com.android.support:exifinterface:28.0.0

Biblioteka pomocy rekomendacji aplikacji na telewizory

Pakiet aplikacji Rekomendacje zawiera interfejsy API umożliwiające dodawanie rekomendacji treści w aplikacji uruchamianej na telewizorach.

Biblioteka aplikacji dodaje obsługę adnotacji, takich jak ContentRecommendation.ContentMaturity i różne klasy, takie jak ContentRecommendation i RecommendationExtender.

Ten pakiet wymaga interfejsu API na poziomie 21 lub wyższym. Identyfikator zależności skryptu kompilacji Gradle dla tej biblioteki jest taki:

com.android.support:recommendation:28.0.0

Biblioteka Wear UI

Ta biblioteka zawiera interfejsy API do tworzenia interfejsów aplikacji na Wear. Interfejsy API, które są dostępne w pakiecie android.support.wear.Widget, zastępują odpowiednie interfejsy API w bibliotece pomocy urządzenia do noszenia.

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

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

com.android.support:wear:28.0.0
Wstecz
功能
Dalej
设置