Hinweis: Mit der Version der Support Library 28.0.0 wurden die mit android.support
gepackten Bibliotheken eingestellt und durch einzeln versionierte Jetpack-Bibliotheken ersetzt, die als androidx
verpackt wurden. Die erste Version 1.0.0 der Jetpack-Bibliotheken ist mit der Support Library 28.0.0 identisch und bietet einen Ausgangspunkt für die Migration zum neuen androidx
-Paket.
Die vorhandenen mit android.support
gepackten Bibliotheken funktionieren weiterhin, erhalten jedoch keine Updates über Version 28.0.0 hinaus und sind nicht mit neuen Jetpack-Bibliotheken kompatibel.
Historische Artefakte (Version 27 und älter und als android.support
verpackt) bleiben in Google Maven verfügbar. Alle neuen Artefakte werden als androidx
verpackt und erfordern eine Migration von android.support
zu androidx
.
Wir empfehlen, in allen neuen Projekten die Bibliotheken androidx
zu verwenden. Sie sollten auch die Migration vorhandener Projekte in Betracht ziehen, damit sie weiterhin Fehlerkorrekturen und andere Verbesserungen der Bibliothek erhalten.
Die Android Support Library enthält mehrere Bibliothekspakete, die du in deine App einbinden kannst. Jede dieser Bibliotheken unterstützt eine bestimmte Anzahl von Android-Plattformversionen und -Funktionen.
Wenn du eine der folgenden Bibliotheken verwenden möchtest, musst du die entsprechenden Bibliotheksdateien in deine Android SDK-Installation herunterladen. Folgen Sie der Anleitung zum Herunterladen der Supportbibliotheken unter Supportbibliothek einrichten, um diesen Schritt auszuführen. Sie müssen zusätzliche Schritte unternehmen, um eine bestimmte Supportbibliothek in Ihre Anwendung aufzunehmen. Am Ende jedes Bibliotheksabschnitts unten finden Sie wichtige Informationen dazu, wie Sie die Bibliothek in Ihre Anwendung einbinden.
Hinweis:Die SDK-Mindestversion für alle Supportbibliothekspakete ist mindestens API-Level 14. Einige Pakete erfordern eine höhere API-Ebene (siehe unten).
v4-Supportbibliotheken
Diese Bibliotheken enthalten im Vergleich zu den anderen Bibliotheken den meisten API-Satz. Dazu zählen auch die Unterstützung von Anwendungskomponenten, Benutzeroberflächenfunktionen, Zugänglichkeit, Datenverarbeitung, Netzwerkkonnektivität und Programmierdienstprogrammen.
Vollständige und detaillierte Informationen zu den von den v4-Supportbibliotheken bereitgestellten Klassen und Methoden finden Sie im Paket android.support.v4
in der API-Referenz.
Hinweis: Vor Version 24.2.0 der Support Library gab es nur eine Supportbibliothek für Version 4. Diese Bibliothek wurde zur Verbesserung der Effizienz in mehrere Module unterteilt. Wenn du support-v4
in deinem Gradle-Skript aufführst, enthält deine App aus Gründen der Abwärtskompatibilität alle Module der Version 4. Zur Verringerung der App-Größe empfehlen wir jedoch, nur die spezifischen Module aufzulisten, die Ihre App benötigt.
v4-kompatible Bibliothek
Bietet Kompatibilitäts-Wrapper für eine Reihe von Framework-APIs wie Context.obtainDrawable()
und View.performAccessibilityAction()
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-compat:28.0.0
Core-utils-Bibliothek von v4
Bietet eine Reihe von Dienstprogrammklassen wie AsyncTaskLoader
und PermissionChecker
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-core-utils:28.0.0
v4 Core-UI-Bibliothek
Implementiert eine Vielzahl von UI-bezogenen Komponenten, z. B. ViewPager
, NestedScrollView
und ExploreByTouchHelper
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-core-ui:28.0.0
v4-mediakompatible Bibliothek
Backportiert Teile des media-Frameworks, einschließlich MediaBrowser
und MediaSession
, rückportiert.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-media-compat:28.0.0
v4-Fragmentbibliothek
Bietet Unterstützung für die Kapselung von Benutzeroberflächen und Funktionen mit Fragmenten, sodass Anwendungen Layouts bereitstellen können, die sich zwischen Geräten mit kleinem und großem Bildschirm anpassen. Dieses Modul weist Abhängigkeiten von compat, core-utils, core-ui und media-compat auf.
Hinweis: Die Supportbibliothek für Version 13 enthält eine FragmentCompat
-Klasse. Die Fragment
-Klasse von Version 4 ist eine eigenständige Klasse mit Fehlerkorrekturen, die in späteren Plattformversionen hinzugefügt wurden. Die Klasse FragmentCompat
der Version 13 hingegen bietet Kompatibilitäts-Shims für die Framework-Implementierung der Klasse Fragment
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-fragment:28.0.0
Multidex-Supportbibliothek
Diese Bibliothek unterstützt die Erstellung von Anwendungen mit mehreren Dalvik Executable-Dateien (DEX). Apps, die auf mehr als 65.536 Methoden verweisen, müssen Multidex-Konfigurationen verwenden. Weitere Informationen zur Verwendung von Multidex finden Sie unter Anwendungen mit über 64.000 Methoden erstellen.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:multidex:1.0.0
v7-Supportbibliotheken
Diese Bibliotheken stellen bestimmte Feature-Sets bereit und können unabhängig voneinander in Ihre Anwendung aufgenommen werden.
v7 appcompat-Bibliothek Teil von Android Jetpack
Hinweis:Die Appcompat-Bibliothek wurde zur AndroidX-Bibliothek migriert, einer Android-Jetpack-Komponente. Sehen Sie sich die Verwendung in der Sunflower-Demo-App an.
Diese Bibliothek unterstützt das Designmuster der Benutzeroberfläche der Aktionsleiste. Diese Bibliothek unterstützt Implementierungen der Benutzeroberfläche Material Design.
Hinweis: Diese Bibliothek hängt von der Supportbibliothek von v4 ab.
Dies sind einige der wichtigsten Klassen, die in der Appcompat-Bibliothek der Version 7 enthalten sind:
ActionBar
: stellt eine Implementierung des Musters der Benutzeroberfläche für die Aktionsleiste bereit. Weitere Informationen zur Verwendung der Aktionsleiste finden Sie im Entwicklerleitfaden für die Aktionsleiste.AppCompatActivity
: Fügt eine Anwendungsaktivitätsklasse hinzu, die als Basisklasse für Aktivitäten verwendet werden kann, die die Aktionsleistenimplementierung der Support Library verwenden.AppCompatDialog
: Fügt eine Dialogklasse hinzu, die als Basisklasse für Dialoge im AppCompat-Design verwendet werden kann.ShareActionProvider
: bietet Unterstützung für eine standardisierte Freigabeaktion (z. B. E-Mails oder Beiträge in sozialen Anwendungen), die in eine Aktionsleiste eingefügt werden können.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:appcompat-v7:28.0.0
CardView-Bibliothek (Version 7)
Diese Bibliothek unterstützt das Widget CardView
, mit dem du Informationen auf Karten anzeigen kannst, die in jeder App einheitlich aussehen. Diese Karten sind für Material Design-Implementierungen nützlich und werden häufig in Layouts für TV-Apps verwendet.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:cardview-v7:28.0.0
v7-Rasterlayout-Bibliothek
Nachdem Sie die Android Support Libraries heruntergeladen haben, unterstützt diese Bibliothek die Klasse GridLayout
, mit der Sie Elemente der Benutzeroberfläche mithilfe eines Rasters aus rechteckigen Zellen anordnen können.
Ausführliche Informationen zu den V7-Grid-Layout-Bibliotheks-APIs finden Sie in der API-Referenz im Paket android.support.v7.widget
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:gridlayout-v7:28.0.0
v7-Mediarouter-Bibliothek
Diese Bibliothek enthält MediaRouter
, MediaRouteProvider
und zugehörige Medienklassen, die Google Cast unterstützen.
Im Allgemeinen bieten die APIs in der v7-Mediarouter-Bibliothek eine Möglichkeit, das Routing von Medienkanälen und -streams vom aktuellen Gerät zu externen Bildschirmen, Lautsprechern und anderen Zielgeräten zu steuern. Die Bibliothek enthält APIs zum Veröffentlichen von appspezifischen Medienroutenanbietern, zum Erkennen und Auswählen von Zielgeräten, zum Überprüfen des Medienstatus und mehr. Ausführliche Informationen zu den Mediarouter-Bibliotheks-APIs von Version 7 finden Sie in der API-Referenz im Paket android.support.v7.media
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:mediarouter-v7:28.0.0
Die in Support Library r18 eingeführten Mediarouter-Bibliotheks-APIs der Version 7 können sich in späteren Versionen der Supportbibliothek ändern. Derzeit empfehlen wir, die Mediathek nur in Verbindung mit Google Cast zu verwenden.
Palettenbibliothek für Version 7
Die V7-Palettenunterstützungsbibliothek enthält die Klasse Palette
, mit der Sie auffällige Farben aus einem Bild extrahieren können. Eine Musik-App könnte beispielsweise ein Palette
-Objekt verwenden, um die Hauptfarben aus einem Albumcover zu extrahieren und mit diesen Farben eine Songtitelkarte zu erstellen, die farblich auf sie abgestimmt ist.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:palette-v7:28.0.0
v7 recyclerview-Bibliothek
Die recyclerview-Bibliothek fügt die Klasse RecyclerView
hinzu. Diese Klasse unterstützt das Widget RecyclerView. Mit dieser Ansicht können große Datasets effizient angezeigt werden, indem ein begrenztes Fenster mit Datenelementen bereitgestellt wird.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:recyclerview-v7:28.0.0
Supportbibliothek für v7-Einstellungen
Das preference-Paket enthält APIs zum Hinzufügen von Präferenzobjekten wie CheckBoxPreference
und ListPreference
, über die Nutzer UI-Einstellungen ändern können.
Die v7-Einstellungsbibliothek unterstützt Schnittstellen wie Preference.OnPreferenceChangeListener
und Preference.OnPreferenceClickListener
sowie Klassen wie CheckBoxPreference
und ListPreference
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:preference-v7:28.0.0
v8-Supportbibliothek
Diese Bibliothek stellt bestimmte Feature-Sets bereit und kann unabhängig von anderen Bibliotheken in Ihre Anwendung aufgenommen werden.
RenderScript-Bibliothek (v8)
Diese Bibliothek unterstützt das Rechen-Framework RenderScript. Diese APIs sind im Paket android.support.v8.renderscript
enthalten. Die Schritte zum Einbinden dieser APIs in Ihre Anwendung unterscheiden sich stark von denen anderer Supportbibliotheks-APIs. Weitere Informationen zur Verwendung dieser APIs in deiner Anwendung findest du im RenderScript-Entwicklerleitfaden.
Hinweis:Die Verwendung von RenderScript mit der Supportbibliothek wird bei Android Studio- und Gradle-basierten Builds unterstützt. Die Renderingscript-Bibliothek befindet sich im Ordner build-tools/$VERSION/renderscript/
.
Das folgende Beispiel zeigt die Attribute des Gradle-Build-Skripts für diese Bibliothek:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
v13-Supportbibliothek
Diese Bibliothek unterstützt das Benutzeroberflächenmuster Fragment mit der Klasse (FragmentCompat
) und zusätzliche Supportklassen für Fragmente. Weitere Informationen zu Fragmenten findest du im Entwicklerleitfaden zu Fragmenten. Ausführliche Informationen zu den Support Library APIs von v13 finden Sie in der API-Referenz im Paket android.support.v13
.
Hinweis: Die v4-Fragmentbibliothek bietet eine Fragment
-Klasse. Die Fragment
-Klasse von Version 4 ist eine eigenständige Klasse mit Fehlerkorrekturen, die in späteren Plattformversionen hinzugefügt wurden. Die Klasse FragmentCompat
der Version 13 hingegen bietet Kompatibilitäts-Shims für die Framework-Implementierung der Klasse Fragment
.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-v13:28.0.0
Supportbibliothek für v14-Einstellungen
Das Paket android.support.v14.preference
bietet APIs, um bevorzugte Schnittstellen wie PreferenceFragment.OnPreferenceStartFragmentCallback
und PreferenceFragment.OnPreferenceStartScreenCallback
sowie Klassen wie MultiSelectListPreference
und PreferenceFragment
zu unterstützen. Ausführliche Informationen zu den Präferenz-Supportbibliotheks-APIs von v14 finden Sie im preference-Paket in der API-Referenz.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:preference-v14:28.0.0
v17-Einstellungs-Supportbibliothek für TV
Das Paket android.support.v17.preference
enthält APIs zur Bereitstellung von bevorzugten Schnittstellen auf Fernsehern, einschließlich Unterstützung der LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
-Schnittstelle und -Klassen wie BaseLeanbackPreferenceFragment
und LeanbackPreferenceFragment
. Ausführliche Informationen zu den Präferenz-Supportbibliotheks-APIs von v17 finden Sie im preference-Paket in der API-Referenz.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Die Gradle-Build-Skript-Abhängigkeitskennung für diese Bibliothek lautet:
com.android.support:preference-leanback-v17:28.0.0
Leanback-Bibliothek für Version 17
Das Paket android.support.v17.leanback
enthält APIs zur Unterstützung der Erstellung von Benutzeroberflächen auf Fernsehgeräten. Sie enthält eine Reihe wichtiger Widgets für TV-Apps. Zu den bemerkenswerten Klassen gehören:
BrowseFragment
: ein Fragment zum Erstellen eines primären Layouts zum Durchsuchen von Kategorien und Zeilen von Medienelementen.DetailsFragment
: Ein Wrapper-Fragment für die Leanback-Detailbildschirme.PlaybackOverlayFragment
: Eine abgeleitete Klasse vonDetailsFragment
zum Anzeigen von Wiedergabesteuerungen und zugehörigen Inhalten.SearchFragment
: ein Fragment zur Verarbeitung von Suchanfragen. Das Fragment empfängt die Suchanfrage des Nutzers und übergibt sie an die von der Anwendung bereitgestellteSearchResultProvider
.SearchResultProvider
gibt die Suchergebnisse an dasSearchFragment
-Element zurück, das sie in einRowsFragment
-Objekt konvertiert.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Die Gradle-Build-Skript-Abhängigkeitskennung für diese Bibliothek lautet:
com.android.support:leanback-v17:28.0.0
Vektor-Drawable-Bibliothek
Bietet Unterstützung für statische Vektorgrafiken.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-vector-drawable:28.0.0
Animierte Vektor-Drawable-Bibliothek
Bietet Unterstützung für animierte Vektorgrafiken.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:animated-vector-drawable:28.0.0
Supportbibliothek für Anmerkungen
Das Paket Annotation stellt APIs zur Verfügung, mit denen Sie Ihren Anwendungen Annotationsmetadaten hinzufügen können.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:support-annotations:28.0.0
Design-Supportbibliothek
Das Design-Paket enthält APIs, die das Hinzufügen von Material Design-Komponenten und -Mustern zu Ihren Anwendungen unterstützen.
Die Design Support Library unterstützt verschiedene Material Design-Komponenten und -Muster, auf denen App-Entwickler aufbauen können, z. B. Navigationsleisten, unverankerte Aktionsschaltflächen (FAB), Snackbars und Tabs.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:design:28.0.0
Supportbibliothek für benutzerdefinierte Tabs
Das Paket Benutzerdefinierte Tabs enthält APIs, mit denen Sie benutzerdefinierte Tabs in Ihren Apps hinzufügen und verwalten können.
Die Bibliothek zur Unterstützung benutzerdefinierter Tabs unterstützt verschiedene Klassen, z. B. den Dienst für benutzerdefinierte Tabs und den Callback für benutzerdefinierte Tabs.
Für dieses Paket ist API-Level 15 oder höher erforderlich. Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:customtabs:28.0.0
Supportbibliothek von Percent
Das Paket Percent enthält APIs, mit denen Sie prozentbasierte Dimensionen in Ihrer Anwendung hinzufügen und verwalten können.
Hinweis:Ab Version 26.0.0 wurde die Percent Support-Bibliothek eingestellt.
Clients dieses Moduls sollten zum neuen ConstraintLayout
-Widget migrieren, das als separates Artefakt in SDK Manager bereitgestellt wird.
Die Percent-Supportbibliothek unterstützt die PercentLayoutHelper.PercentLayoutParams-Schnittstelle und verschiedene Klassen wie PercentFrameLayout und PercentRelativeLayout.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:percent:28.0.0
ExifInterface-Supportbibliothek
EXIF-Tags speichern Informationen wie Ausrichtung, Datum und Uhrzeit, Kamerainformationen und Standort direkt in einer JPEG- oder RAW-Datei. Die Klasse ExifInterface
entbündelt die Unterstützung für das Lesen von EXIF-Informationen aus JPEG- und Rohdateien (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW und RAF) und das Festlegen der EXIF-Informationen auf JPEG-Bilddateien.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:exifinterface:28.0.0
Supportbibliothek für App-Empfehlungen für TV
Das Paket App-Empfehlung enthält APIs, die das Hinzufügen von Inhaltsempfehlungen in Apps unterstützen, die auf Fernsehern ausgeführt werden.
Die App-Bibliothek unterstützt Annotationen wie ContentRecommendation.ContentMaturity und verschiedene Klassen wie ContentRecommendation und RecommendationExtender.
Für dieses Paket ist API-Level 21 oder höher erforderlich. Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:recommendation:28.0.0
Wear-UI-Bibliothek
Diese Bibliothek enthält APIs zum Erstellen von Benutzeroberflächen für Wear-Apps. Die APIs, die im Paket android.support.wear.widget verfügbar sind, ersetzen die entsprechenden APIs in der Wearable-Supportbibliothek.
Weitere Informationen findest du unter Wear-UI-Bibliothek verwenden.
Die Abhängigkeitskennung des Gradle-Build-Skripts für diese Bibliothek lautet:
com.android.support:wear:28.0.0