Hinweis: Mit der Veröffentlichung der Support Library 28.0.0 wurden die mit android.support
verpackten Bibliotheken verworfen und durch individuell versionierte Jetpack-Bibliotheken im Format androidx
ersetzt. Der erste Release 1.0.0 der Jetpack-Bibliotheken entspricht der Support Library 28.0.0 und bietet einen Ausgangspunkt für die Migration zur neuen androidx
-Paketerstellung.
Die vorhandenen Bibliotheken mit android.support
-Paketen funktionieren weiterhin. Sie erhalten jedoch keine Updates nach Version 28.0.0 und sind nicht mit neuen Jetpack-Bibliotheken kompatibel.
Bisherige Artefakte (Version 27 und niedriger, als android.support
verpackt) sind weiterhin bei Google Maven verfügbar. Alle neuen Artefakte werden als androidx
verpackt und müssen von android.support
nach androidx
migriert werden.
Wir empfehlen, die androidx
-Bibliotheken in allen neuen Projekten zu verwenden. Sie sollten auch bestehende Projekte migriert haben, damit sie weiterhin Fehlerkorrekturen und andere Bibliotheksverbesserungen erhalten.
Die Android-Supportbibliothek enthält mehrere Bibliothekspakete, die Sie in Ihre App einbinden können. Jede dieser Bibliotheken unterstützt eine Reihe von Android-Plattformversionen und -Funktionen.
Wenn du eine der folgenden Bibliotheken verwenden möchtest, musst du sie in deine Android SDK-Installation herunterladen. Folgen Sie der Anleitung zum Herunterladen der Supportbibliotheken unter Einrichtung der Supportbibliothek, um diesen Schritt abzuschließen. Sie müssen zusätzliche Schritte ausführen, um eine bestimmte Supportbibliothek in Ihre Anwendung aufzunehmen. Unten am Ende jedes Abschnitts 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. Für einige Pakete ist eine höhere API-Ebene erforderlich, wie unten angegeben.
v4-Supportbibliotheken
Diese Bibliotheken enthalten im Vergleich zu den anderen Bibliotheken die größte Anzahl von APIs, einschließlich Unterstützung für Anwendungskomponenten, Benutzeroberflächenfunktionen, Barrierefreiheit, Datenhandhabung, Netzwerkverbindung und Programmierdienstprogramme.
Vollständige, ausführliche Informationen zu den Klassen und Methoden, die von den v4-Supportbibliotheken bereitgestellt werden, finden Sie im android.support.v4
-Paket in der API-Referenz.
Hinweis:Vor der Version 24.2.0 der Supportbibliothek gab es nur eine Supportbibliothek für Version 4. Diese Bibliothek wurde zur Leistungssteigerung in mehrere Module unterteilt. Wenn Sie support-v4
in Ihrem Gradle-Skript angeben, enthält Ihre App aus Gründen der Abwärtskompatibilität alle V4-Module. Um die App-Größe zu reduzieren, empfehlen wir jedoch, nur die Module aufzulisten, die für Ihre App erforderlich sind.
v4 compat library
Bietet Kompatibilitäts-Wrapper für eine Reihe von Framework-APIs wie Context.obtainDrawable()
und View.performAccessibilityAction()
.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-compat:28.0.0
v4 core-utils library
Bietet eine Reihe von Dienstprogrammklassen wie AsyncTaskLoader
und PermissionChecker
.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-core-utils:28.0.0
v4 core-ui library
Implementiert eine Vielzahl von UI-bezogenen Komponenten wie ViewPager
, NestedScrollView
und ExploreByTouchHelper
.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-core-ui:28.0.0
v4-Media-Compat-Bibliothek
Portiert Teile des Media-Frameworks, einschließlich MediaBrowser
und MediaSession
.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-media-compat:28.0.0
V4-Fragmentbibliothek
Es wird die Unterstützung für die Kapselung der Benutzeroberfläche und Funktionalität mit Fragmenten hinzugefügt. So können Apps Layouts bereitstellen, die sich an Geräte mit kleinen und großen Bildschirmen anpassen. Dieses Modul hat Abhängigkeiten von compat, core-utils, core-ui und media-compat.
Hinweis:Die Supportbibliothek v13 bietet eine FragmentCompat
-Klasse. Die Fragment
-Klasse der Version 4 ist eine eigenständige Klasse, die Fehlerkorrekturen enthält, die in späteren Plattformversionen hinzugefügt wurden. Die FragmentCompat
-Klasse der Version 13 bietet hingegen Kompatibilitäts-Shims für die Framework-Implementierung der Fragment
-Klasse.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-fragment:28.0.0
Multidex Support Library
Diese Bibliothek unterstützt das Erstellen von Apps mit mehreren DEX-Dateien (Dalvik Executable). Für Apps, die auf mehr als 65.536 Methoden verweisen, müssen Multidex-Konfigurationen verwendet werden. Weitere Informationen zur Verwendung von Multidex finden Sie unter Apps mit über 64.000 Methoden erstellen.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:multidex:1.0.0
Supportbibliotheken der Version 7
Diese Bibliotheken bieten bestimmte Funktionspakete und können unabhängig voneinander in Ihre Anwendung aufgenommen werden.
AppCompat-Bibliothek der Version 7 Teil von Android Jetpack.
Hinweis:Die AppCompat-Bibliothek wurde in die AndroidX-Bibliothek migriert, eine Android Jetpack-Komponente. Sehen Sie sich die Verwendung in der Sunflower-Demo-App an.
Diese Bibliothek unterstützt das Designmuster für die Benutzeroberfläche der Aktionsleiste. Diese Bibliothek unterstützt die Implementierung von Material Design-Benutzeroberflächen.
Hinweis:Diese Bibliothek ist von der Supportbibliothek v4 abhängig.
Hier sind einige der wichtigsten Klassen in der AppCompat-Bibliothek der Version 7:
ActionBar
– Bietet eine Implementierung des Benutzeroberflächenmusters für die Aktionsleiste. Weitere Informationen zur Verwendung der Aktionsleiste finden Sie im Entwicklerhandbuch zur Aktionsleiste.AppCompatActivity
– Fügen Sie eine Anwendungsaktivitätsklasse hinzu, die als Basisklasse für Aktivitäten verwendet werden kann, die die Aktionsleiste der Support Library verwenden.AppCompatDialog
: Fügt eine Dialogklasse hinzu, die als Basisklasse für AppCompat-Dialogfelder verwendet werden kann.ShareActionProvider
: Es wird Unterstützung für eine standardisierte Freigabeaktion hinzugefügt (z. B. per E-Mail oder in sozialen Netzwerken), die in einer Aktionsleiste enthalten sein kann.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:appcompat-v7:28.0.0
v7-Bibliothek für Kartenansicht
Diese Bibliothek unterstützt das CardView
-Widget, mit dem Sie Informationen in Karten anzeigen können, die in jeder App einheitlich aussehen. Diese Karten sind nützlich für Material Design-Implementierungen und werden häufig in Layouts für TV-Apps verwendet.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:cardview-v7:28.0.0
v7-Gridlayout-Bibliothek
Nachdem Sie die Android-Supportbibliotheken heruntergeladen haben, wird diese Bibliothek um die Unterstützung der Klasse GridLayout
erweitert. Damit können Sie Benutzeroberflächenelemente in einem Raster aus rechteckigen Zellen anordnen.
Ausführliche Informationen zu den APIs der v7-Gridlayout-Bibliothek finden Sie in der API-Referenz im Paket android.support.v7.widget
.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:gridlayout-v7:28.0.0
v7 mediarouter library
Diese Bibliothek bietet MediaRouter
, MediaRouteProvider
und verwandte Medienklassen, die Google Cast unterstützen.
Im Allgemeinen bieten die APIs in der Mediarouter-Bibliothek der Version 7 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 unter anderem APIs zum Veröffentlichen von appspezifischen Media-Route-Anbietern, zum Entdecken und Auswählen von Zielgeräten und zum Prüfen des Medienstatus. Ausführliche Informationen zu den Mediarouter-Bibliotheks-APIs der Version 7 findest du im Paket android.support.v7.media
in der API-Referenz.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:mediarouter-v7:28.0.0
Die in der Support Library r18 eingeführten APIs der Mediarouter-Bibliothek v7 können in späteren Versionen der Support Library geändert werden. Wir empfehlen derzeit, die Bibliothek nur in Verbindung mit Google Cast zu verwenden.
v7-Palettenbibliothek
Die V7-Supportbibliothek für die Palette enthält die Klasse Palette
, mit der Sie auffällige Farben aus einem Bild extrahieren können. In einer Musik-App könnte beispielsweise ein Palette
-Objekt verwendet werden, um die Hauptfarben aus einem Albumcover zu extrahieren und mit diesen Farben eine farblich abgestimmte Titelkarte für den Song zu erstellen.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:palette-v7:28.0.0
v7 recyclerview library
Die recyclerview-Bibliothek fügt die Klasse RecyclerView
hinzu. Diese Klasse unterstützt das RecyclerView-Widget, eine Ansicht, mit der sich große Datensätze effizient darstellen lassen, indem nur ein begrenzter Bereich von Datenelementen angezeigt wird.
Die ID für die Abhängigkeit des Gradle-Build-Skripts für diese Bibliothek lautet so:
com.android.support:recyclerview-v7:28.0.0
v7 Preference Support Library
Das Paket preference bietet APIs zum Hinzufügen von Einstellungsobjekten wie CheckBoxPreference
und ListPreference
, mit denen Nutzer die UI-Einstellungen ändern können.
Die Preference-Bibliothek der Version 7 unterstützt jetzt auch Schnittstellen wie Preference.OnPreferenceChangeListener
und Preference.OnPreferenceClickListener
sowie Klassen wie CheckBoxPreference
und ListPreference
.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:preference-v7:28.0.0
V8-Supportbibliothek
Diese Bibliothek bietet bestimmte Funktionspakete und kann unabhängig von anderen Bibliotheken in Ihre Anwendung aufgenommen werden.
Renderingscript-Bibliothek von Version 8
Diese Bibliothek unterstützt das RenderScript-Berechnungsframework. 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 Supportbibliotheken. Weitere Informationen zur Verwendung dieser APIs in Ihrer Anwendung finden Sie im Entwicklerhandbuch für RenderScript.
Hinweis:Die Verwendung von RenderScript mit der Supportbibliothek wird in Android Studio und in Gradle-basierten Builds unterstützt. Die Renderingscript-Bibliothek befindet sich im Ordner build-tools/$VERSION/renderscript/
.
Im folgenden Beispiel sind die Eigenschaften des Gradle-Build-Scripts für diese Bibliothek zu sehen:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
Support Library v13
Diese Bibliothek bietet Unterstützung für das Fragment-Nutzeroberflächenmuster mit der Klasse (FragmentCompat
) und zusätzlichen Klassen zur Fragmentunterstützung. Weitere Informationen zu Fragmenten finden Sie im Entwicklerhandbuch unter Fragmente. Ausführliche Informationen zu den Support Library APIs der Version 13 finden Sie im Paket android.support.v13
in der API-Referenz.
Hinweis:Die Fragmentbibliothek für Version 4 bietet eine Fragment
-Klasse. Die Fragment
-Klasse von v4 ist eine eigenständige Klasse mit Fehlerkorrekturen, die in späteren Plattformversionen hinzugefügt wurden. Die FragmentCompat
-Klasse von v13 bietet Kompatibilitäts-Shims für die Framework-Implementierung der Fragment
-Klasse.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:support-v13:28.0.0
Supportbibliothek für Version 14
Das android.support.v14.preference
-Paket bietet APIs, um Unterstützung für Einstellungsoberflächen wie PreferenceFragment.OnPreferenceStartFragmentCallback
und PreferenceFragment.OnPreferenceStartScreenCallback
sowie Klassen wie MultiSelectListPreference
und PreferenceFragment
hinzuzufügen. Ausführliche Informationen zu den APIs der Preference Support Library Version 14 finden Sie im Paket preference in der API-Referenz.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:preference-v14:28.0.0
v17 Preference Support Library für TV
Das Paket android.support.v17.preference
bietet APIs für die Bereitstellung von Einstellungsoberflächen auf Fernsehern, einschließlich Unterstützung für die LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
-Schnittstelle und Klassen wie BaseLeanbackPreferenceFragment
und LeanbackPreferenceFragment
. Detaillierte Informationen zu den APIs der Preference Support Library Version 17 finden Sie im Paket preference in der API-Referenz.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Die ID für die Abhängigkeit des Gradle-Build-Skripts für diese Bibliothek lautet so:
com.android.support:preference-leanback-v17:28.0.0
Leanback-Mediathek der Version 17
Das android.support.v17.leanback
-Paket bietet APIs zum Erstellen von Benutzeroberflächen auf Fernsehern. Es bietet eine Reihe wichtiger Widgets für TV-Apps. Zu den herausragenden Klassen gehören:
BrowseFragment
– ein Fragment zum Erstellen eines primären Layouts für die Navigation durch Kategorien und Zeilen von Medienelementen.DetailsFragment
: Ein Wrapper-Fragment für Leanback-Detailbildschirme.PlaybackOverlayFragment
– eine Unterklasse vonDetailsFragment
zum Anzeigen der Wiedergabesteuerung und ähnlicher InhalteSearchFragment
: Ein Fragment zum Verarbeiten von Suchanfragen. Das Fragment empfängt die Suchanfrage des Nutzers und übergibt sie an das von der Anwendung bereitgestellteSearchResultProvider
.SearchResultProvider
gibt die Suchergebnisse anSearchFragment
zurück, die sie dann in einRowsFragment
umwandeln.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Die Abhängigkeits-ID des Gradle-Build-Scripts für diese Bibliothek lautet:
com.android.support:leanback-v17:28.0.0
Vektor-Drawable-Bibliothek
Unterstützt statische Vektorgrafiken.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:support-vector-drawable:28.0.0
Animierte Vektor-Drawable-Bibliothek
Unterstützt animierte Vektorgrafiken.
Die Gradle-Build-Skript-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:animated-vector-drawable:28.0.0
Supportbibliothek für Anmerkungen
Das Annotation-Paket bietet APIs, mit denen Sie Ihren Apps Anmerkungsmetadaten hinzufügen können.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:support-annotations:28.0.0
Design Support Library
Das Paket Design bietet APIs, mit denen Sie Ihren Apps Material Design-Komponenten und -Muster hinzufügen können.
Die Design Support Library bietet Unterstützung für verschiedene Material Design-Komponenten und -Muster, auf die App-Entwickler aufbauen können, z. B. Navigationsleisten, Floating Action Buttons (FABs), Snackbars und Tabs.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:design:28.0.0
Supportbibliothek für benutzerdefinierte Tabs
Das Paket Benutzerdefinierte Tabs bietet APIs zum Hinzufügen und Verwalten benutzerdefinierter Tabs in Ihren Apps.
Die Custom Tabs-Supportbibliothek bietet Unterstützung für verschiedene Klassen, z. B. Custom Tabs Service und Custom Tabs Callback.
Für dieses Paket ist API-Level 15 oder höher erforderlich. Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:customtabs:28.0.0
Supportbibliothek für Prozentzahlen
Das Paket Percent enthält APIs, mit denen Sie prozentuale Dimensionen in Ihrer Anwendung hinzufügen und verwalten können.
Hinweis:Seit Version 26.0.0 wird die Prozentsatz-Unterstützungsbibliothek nicht mehr unterstützt.
Kunden dieses Moduls sollten zum neuen Widget ConstraintLayout
migrieren, das im SDK Manager als separates Artefakt bereitgestellt wird.
Die Percent-Supportbibliothek unterstützt die Oberfläche PercentLayoutHelper.PercentLayoutParams und verschiedene Klassen wie PercentFrameLayout und PercentRelativeLayout.
Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:
com.android.support:percent:28.0.0
ExifInterface Support Library
Exif-Tags speichern Informationen wie die Ausrichtung, Datum und Uhrzeit, Kamerainformationen und den Standort direkt in einer JPEG- oder RAW-Datei. Die Klasse ExifInterface
unterstützt das Lesen von Exif-Informationen aus JPEG- und RAW-Dateien (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW und RAF) und das Festlegen der Exif-Informationen in JPEG-Bilddateien.
Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:exifinterface:28.0.0
Supportbibliothek für App-Empfehlungen für Fernseher
Das Paket App-Empfehlungen enthält APIs, mit denen du deiner App, die auf Fernsehern ausgeführt wird, Inhaltsempfehlungen hinzufügen kannst.
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 Gradle-Build-Script-Abhängigkeits-ID 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 Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:
com.android.support:wear:28.0.0