Bibliothekspakete unterstützen

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:

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