Bibliothekspakete unterstützen

Hinweis:Mit der Veröffentlichung der Support Library 28.0.0 werden die in android.support verpackten Bibliotheken eingestellt und durch einzeln versionierte Jetpack-Bibliotheken ersetzt, die als androidx verpackt sind. 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 android.support-Bibliotheken funktionieren weiterhin, erhalten jedoch keine Updates mehr über Version 28.0.0 hinaus 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 zu 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-Unterstützungsbibliothek enthält mehrere Bibliothekspakete, die in Ihre Anwendung eingefügt werden können. Jede dieser Bibliotheken unterstützt eine bestimmte Reihe von Android-Plattformversionen und -Funktionen.

Wenn Sie eine der folgenden Bibliotheken verwenden möchten, müssen Sie die Bibliotheksdateien in Ihre 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 Mindest-SDK-Version 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 und detaillierte Informationen zu den Klassen und Methoden, die von den V4-Unterstützungsbibliotheken bereitgestellt werden, finden Sie im Paket android.support.v4 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-Script angeben, enthält Ihre App zur 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 library

Backports von Teilen 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 enthält 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-Supportbibliothek

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 Gradle-Build-Script-Abhängigkeits-ID 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. In der Demo-App Sunflower sehen Sie, wie sie verwendet wird.

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 Implementierung der Support Library-Aktionsleiste verwenden.
  • AppCompatDialog: Hiermit wird eine Dialogklasse hinzugefügt, die als Basisklasse für AppCompat-Dialogfelder verwendet werden kann.
  • ShareActionProvider: Unterstützung für eine standardisierte Freigabeaktion (z. B. per E-Mail oder in sozialen Netzwerken) hinzugefügt, 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 Gradle-Build-Script-Abhängigkeits-ID 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 im Paket android.support.v7.widget in der API-Referenz.

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 zugehörige 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 APIs der Mediarouter-Bibliothek der Version 7 findest du im Paket android.support.v7.media in der API-Referenz.

Die Gradle-Build-Script-Abhängigkeits-ID 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 Paletten-Unterstützungsbibliothek der Version 7 enthält die Klasse Palette, mit der Sie markante 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 Widget RecyclerView, eine Ansicht, mit der sich große Datensätze effizient darstellen lassen, indem nur ein begrenzter Bereich von Datenelementen angezeigt wird.

Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:

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 Gradle-Build-Script-Abhängigkeits-ID 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.

v8 RenderScript-Bibliothek

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 RenderScript-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 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-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 Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:

com.android.support:preference-v14:28.0.0

Supportbibliothek für Einstellungen der Version 17 für Fernseher

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 Abhängigkeits-ID des Gradle-Build-Scripts für diese Bibliothek lautet:

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

Leanback-Mediathek der Version 17

Das android.support.v17.leanback-Paket bietet APIs, die das Erstellen von Benutzeroberflächen auf Fernsehern unterstützen. Es bietet eine Reihe wichtiger Widgets für TV-Apps. Zu den bemerkenswerten Kursen gehören:

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 Gradle-Build-Skript-Abhängigkeits-ID 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 Gradle-Build-Script-Abhängigkeits-ID 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 Supportbibliothek für benutzerdefinierte Tabs 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 Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet:

com.android.support:customtabs:28.0.0

Supportbibliothek für Prozentzahlen

Das Paket Prozent bietet APIs zum Hinzufügen und Verwalten von prozentualen Dimensionen in Ihrer App.

Hinweis:Seit Version 26.0.0 wird die Prozentsatz-Unterstützungsbibliothek nicht mehr unterstützt. Kunden dieses Moduls sollten zum neuen ConstraintLayout-Widget migrieren, das im SDK Manager als separates Artefakt bereitgestellt wird.

Die Percent Support-Bibliothek bietet Unterstützung für die Schnittstelle PercentLayoutHelper.PercentLayoutParams und verschiedene Klassen wie PercentFrameLayout und PercentRelativeLayout.

Die Gradle-Build-Script-Abhängigkeits-ID 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-Empfehlung bietet APIs, mit denen Sie Ihrer App, die auf Fernsehern ausgeführt wird, Inhaltsempfehlungen hinzufügen können.

Die App-Mediathek unterstützt Anmerkungen 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 finden Sie unter Wear-UI-Bibliothek verwenden.

Die Gradle-Build-Script-Abhängigkeits-ID für diese Bibliothek lautet: 

com.android.support:wear:28.0.0