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. Historische Artefakte (die Version 27 und frühere Versionen, die als android.support verpackt sind) bleiben in Google Maven verfügbar. Alle neuen Artefakte werden als androidx verpackt und erfordern eine Migration von android.support nach androidx.

Wir empfehlen, die androidx-Bibliotheken in allen neuen Projekten zu verwenden. Sie sollten auch vorhandene Projekte migrieren, 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 unternehmen, um eine bestimmte Support Library in Ihre Anwendung aufzunehmen. Wichtige Informationen dazu, wie Sie die Bibliothek in Ihre Anwendung einbinden können, finden Sie unten am Ende der einzelnen Bibliotheksabschnitte.

Hinweis:Die SDK-Mindestversion für alle Supportbibliothekspakete ist mindestens API-Level 14. Einige Pakete erfordern eine höhere API-Ebene, wie unten angegeben.

v4-Supportbibliotheken

Diese Bibliotheken umfassen im Vergleich zu den anderen Bibliotheken den größten Satz an APIs. Dazu gehören Anwendungskomponenten, Funktionen der Benutzeroberfläche, Bedienungshilfen, Datenverarbeitung, Netzwerkkonnektivität 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 Version 24.2.0 der Support Library gab es nur eine einzige Supportbibliothek der Version 4. Zur Steigerung der Effizienz wurde die Bibliothek in mehrere Module aufgeteilt. Wenn Sie support-v4 in Ihrem Gradle-Skript angeben, enthält Ihre App aus Gründen der Abwärtskompatibilität alle V4-Module. Zur Reduzierung der App-Größe empfehlen wir jedoch, nur die spezifischen Module aufzulisten, die Ihre App benötigt.

v4-kompatible Bibliothek

Stellt Kompatibilitäts-Wrapper für eine Reihe von Framework-APIs bereit, z. B. Context.obtainDrawable() und View.performAccessibilityAction().

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:support-compat:28.0.0

v4-Kerndienstprogrammbibliothek

Stellt eine Reihe von Dienstprogrammklassen wie AsyncTaskLoader und PermissionChecker zur Verfügung.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:support-core-utils:28.0.0

Core-UI-Bibliothek von v4

Implementiert verschiedene UI-bezogene Komponenten wie ViewPager, NestedScrollView und ExploreByTouchHelper.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:support-core-ui:28.0.0

v4-Media-Compat-Bibliothek

Portiert Teile des Medien-Frameworks, einschließlich MediaBrowser und MediaSession.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:support-media-compat:28.0.0

v4-Fragmentbibliothek

Unterstützung für die Kapselung von Benutzeroberfläche und Funktionen mit Fragmenten, sodass Anwendungen Layouts bereitstellen können, die sich für kleine und große Geräte eignen. Dieses Modul ist von compat, core-utils, core-ui und media-compat abhängig.

Hinweis: Die Supportbibliothek von Version 13 bietet eine FragmentCompat-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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:support-fragment:28.0.0

Multidex-Supportbibliothek

Diese Bibliothek bietet Unterstützung für 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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:multidex:1.0.0

v7-Supportbibliotheken

Diese Bibliotheken bieten spezifische Feature-Sets und können unabhängig voneinander in Ihre Anwendung aufgenommen werden.

v7 appcompat-Bibliothek 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 der Benutzeroberfläche Aktionsleiste. Diese Bibliothek unterstützt Implementierungen der Benutzeroberfläche von Material Design.

Hinweis: Diese Bibliothek hängt von der v4-Supportbibliothek ab.

Hier sind einige der wichtigsten Klassen, die in der v7-appcompat-Bibliothek enthalten sind:

  • ActionBar: Implementierung des Musters der Benutzeroberfläche der Aktionsleiste. 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 Implementierung der Support Library-Aktionsleiste verwenden.
  • AppCompatDialog: Fügt eine Dialogklasse hinzu, die als Basisklasse für AppCompat-Dialogfelder verwendet werden kann.
  • ShareActionProvider: Unterstützt standardisierte Freigabeaktionen (z. B. E-Mails oder Beiträge in sozialen Anwendungen), die in eine Aktionsleiste eingefügt werden können.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:appcompat-v7:28.0.0

CardView-Bibliothek (v7)

Diese Bibliothek unterstützt das CardView-Widget, 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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:cardview-v7:28.0.0

Gridlayout-Bibliothek (Version 7)

Nachdem du die Android Support Libraries heruntergeladen hast, unterstützt diese Bibliothek die Klasse GridLayout, mit der du Benutzeroberflächenelemente mithilfe eines Rasters von rechteckigen Zellen anordnen kannst. Ausführliche Informationen zu den APIs der Grid-Layout-Bibliothek von Version 7 finden Sie im Paket android.support.v7.widget in der API-Referenz.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:gridlayout-v7:28.0.0

v7-Mediarouter-Bibliothek

Diese Bibliothek bietet MediaRouter, MediaRouteProvider und verwandte 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 app-spezifischer Anbieter von Medienrouten, zum Erkennen und Auswählen von Zielgeräten, zum Prüfen des Medienstatus usw. Ausführliche Informationen zu den APIs der v7-Mediarouter-Bibliothek finden Sie 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 Supportbibliothek R18 eingeführten APIs der Mediarouter-Bibliothek v7 können in späteren Versionen der Supportbibliothek geändert werden. Derzeit empfehlen wir, die Bibliothek nur in Verbindung mit Google Cast zu verwenden.

Vorlagenbibliothek für Version 7

Die V7-Supportbibliothek für Paletten enthält die Klasse Palette, mit der sich auffällige Farben aus einem Bild extrahieren lassen. Eine Musik-App könnte beispielsweise ein Palette-Objekt verwenden, um die Hauptfarben aus einem Albumcover zu extrahieren und anhand dieser Farben eine farbkoordinierte Titelkarte eines Titels zu erstellen.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:palette-v7:28.0.0

Recyclerview-Bibliothek für Version 7

Die Recyclerview-Bibliothek fügt die Klasse RecyclerView hinzu. Diese Klasse unterstützt das RecyclerView-Widget, eine Ansicht zur effizienten Darstellung großer Datasets, die ein begrenztes Fenster mit Datenelementen bietet.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:recyclerview-v7:28.0.0

Supportbibliothek für v7-Präferenzen

Das Paket preference enthält APIs, mit denen Nutzer Präferenzobjekte wie CheckBoxPreference und ListPreference hinzufügen können, um UI-Einstellungen zu ändern.

Die V7-Einstellungsbibliothek unterstützt 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 stellt bestimmte Feature-Sets bereit und kann unabhängig von anderen Bibliotheken in Ihre Anwendung aufgenommen werden.

Renderingscript-Bibliothek von Version 8

Diese Bibliothek unterstützt das Berechnungs-Framework RenderScript. Diese APIs sind im Paket android.support.v8.renderscript enthalten. Die Schritte zum Einbinden dieser APIs in Ihre Anwendung unterscheiden sich sehr von denen anderer Supportbibliotheken. Weitere Informationen zur Verwendung dieser APIs in Ihrer Anwendung finden Sie 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 Eigenschaften 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 sowie weitere Klassen zur Unterstützung von Fragmenten. Weitere Informationen zu Fragmenten finden Sie im Entwicklerleitfaden zu Fragmenten. Ausführliche Informationen zu den v13 Support Library APIs finden Sie im Paket android.support.v13 in der API-Referenz.

Hinweis: Die Fragmentbibliothek der Version 4 bietet die Klasse Fragment. 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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:support-v13:28.0.0

v14 Preference Support Library

Das Paket android.support.v14.preference bietet APIs zur Unterstützung bevorzugter Schnittstellen wie PreferenceFragment.OnPreferenceStartFragmentCallback und PreferenceFragment.OnPreferenceStartScreenCallback sowie Klassen wie MultiSelectListPreference und PreferenceFragment. Ausführliche Informationen zu den v14 Preference Support Library-APIs finden Sie im preference-Paket 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 zur Bereitstellung bevorzugter Schnittstellen auf Fernsehern, einschließlich Unterstützung für die LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener-Schnittstelle und -Klassen wie BaseLeanbackPreferenceFragment und LeanbackPreferenceFragment. Ausführliche Informationen zu den v17 Preference Support Library-APIs finden Sie im preference-Paket in der API-Referenz.

Für dieses Paket ist API-Level 17 oder höher erforderlich. Die Abhängigkeits-ID des Gradle-Build-Skripts für diese Bibliothek lautet so:

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

Leanback-Bibliothek für Version 17

Das Paket android.support.v17.leanback 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-Skripts für diese Bibliothek lautet so:

com.android.support:leanback-v17:28.0.0

Vector 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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:animated-vector-drawable:28.0.0

Supportbibliothek für Anmerkungen

Das Paket Annotation enthält APIs, mit denen Sie Annotationsmetadaten zu Ihren Anwendungen 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 enthält APIs, mit denen du deinen Apps Material Design-Komponenten und -Muster hinzufügen kannst.

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 (UAS), snackbars und Tabs.

Die ID für die Gradle-Build-Skriptabhängigkeit 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 du benutzerdefinierte Tabs zu deinen Apps hinzufügen und verwalten kannst.

Die Supportbibliothek für benutzerdefinierte 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 ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet:

com.android.support:customtabs:28.0.0

Percent-Supportbibliothek

Das Paket Percent bietet APIs, mit denen Sie prozentuale Dimensionen in Ihrer Anwendung hinzufügen und verwalten können.

Hinweis:Die Percent-Supportbibliothek wurde mit Version 26.0.0 eingestellt. Clients dieses Moduls sollten zum neuen ConstraintLayout-Widget migrieren, das als separates Artefakt im SDK Manager zur Verfügung gestellt 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-Supportbibliothek

EXIF-Tags speichern Informationen wie Ausrichtung, Datum und Uhrzeit, Kamerainformationen und den 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 für JPEG-Bilddateien.

Die ID für die Gradle-Build-Skriptabhängigkeit 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, 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 ID für die Gradle-Build-Skriptabhängigkeit 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 im Paket android.support.wear.widget verfügbaren APIs ersetzen die entsprechenden APIs in der Wearable-Supportbibliothek.

Weitere Informationen findest du unter Wear-UI-Bibliothek verwenden.

Die ID für die Gradle-Build-Skriptabhängigkeit für diese Bibliothek lautet: 

com.android.support:wear:28.0.0