Bibliothekspakete unterstützen

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:

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