Bibliothekspakete unterstützen

Hinweis:Mit der Veröffentlichung der Support Library 28.0.0 sind die im Paket android.support enthaltenen Bibliotheken veraltet und werden durch einzeln versionierte Jetpack-Bibliotheken ersetzt, die als androidx verpackt sind. Die erste Version 1.0.0 der Jetpack-Bibliotheken bietet Parität mit der Support Library 28.0.0 und einen Ausgangspunkt für die Migration zum neuen androidx-Paket.

Die vorhandenen android.support-Paketbibliotheken funktionieren weiterhin. Sie erhalten jedoch keine Updates über Version 28.0.0 hinaus und sind nicht mit neuen Jetpack-Bibliotheken kompatibel. Bisherige Artefakte (Version 27 und früher, verpackt als android.support) sind weiterhin in Google Maven verfügbar. Alle neuen Artefakte werden als androidx verpackt und erfordern eine Migration von android.support zu androidx.

Wir empfehlen, die androidx-Bibliotheken in allen neuen Projekten zu verwenden. Sie sollten auch in Erwägung ziehen, bestehende Projekte zu migrieren, damit sie weiterhin Fehlerkorrekturen und andere Verbesserungen der Bibliothek erhalten.

Die Android-Supportbibliothek enthält mehrere Bibliothekspakete, die in Ihre Anwendung eingebunden werden können. Jede dieser Bibliotheken unterstützt einen bestimmten Bereich von Android-Plattformversionen und eine bestimmte Reihe von 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 Support-Bibliotheken unter Support Library Setup, um diesen Schritt abzuschließen. Sie müssen zusätzliche Schritte ausführen, um eine bestimmte Support Library in Ihre Anwendung einzubinden. Am Ende jedes Bibliotheksabschnitts unten finden Sie wichtige Informationen dazu, wie Sie die Bibliothek in Ihre Anwendung einbinden.

Hinweis:Die Mindest-SDK-Version für alle Support-Bibliothekspakete ist mindestens API-Level 14. Für einige Pakete ist ein höheres API-Level erforderlich, wie unten angegeben.

v4-Supportbibliotheken

Diese Bibliotheken enthalten im Vergleich zu den anderen Bibliotheken die meisten APIs, einschließlich Unterstützung für Anwendungskomponenten, Funktionen der Benutzeroberfläche, Barrierefreiheit, Datenverarbeitung, Netzwerkverbindungen und Programmierdienstprogramme.

Vollständige, detaillierte Informationen zu den Klassen und Methoden, die von den v4-Supportbibliotheken bereitgestellt werden, finden Sie im Paket android.support.v4 in der API-Referenz.

Hinweis:Vor der Support Library-Version 24.2.0 gab es nur eine einzige v4-Supportbibliothek. Diese Bibliothek wurde in mehrere Module unterteilt, um die Effizienz zu verbessern. Aus Gründen der Abwärtskompatibilität werden alle v4-Module in Ihre App aufgenommen, wenn Sie support-v4 in Ihrem Gradle-Skript angeben. Um die App-Größe zu verringern, empfehlen wir jedoch, nur die spezifischen Module aufzulisten, die Ihre App benötigt.

v4-Kompatibilitätsbibliothek

Bietet Kompatibilitäts-Wrapper für eine Reihe von Framework-APIs wie Context.obtainDrawable() und View.performAccessibilityAction().

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

com.android.support:support-compat:28.0.0

v4-Kern-Dienstprogrammbibliothek

Bietet eine Reihe von Dienstprogrammklassen wie AsyncTaskLoader und PermissionChecker.

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

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

v4-Core-UI-Bibliothek

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

Die Gradle-Build-Skript-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-Skript-Abhängigkeits-ID 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 Funktionalität mit Fragmenten wurde hinzugefügt. Dadurch können Anwendungen 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 Support-Bibliothek v13 bietet eine FragmentCompat-Klasse. Die Klasse v4 Fragment ist eine eigenständige Klasse, die Fehlerkorrekturen enthält, die in späteren Plattformversionen hinzugefügt wurden. Die Klasse v13 FragmentCompat bietet Kompatibilitäts-Shims für die Framework-Implementierung der Klasse Fragment.

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

com.android.support:support-fragment:28.0.0

Multidex Support Library

Diese Bibliothek bietet Unterstützung für die Entwicklung von Apps mit mehreren DEX-Dateien (Dalvik Executable). Apps, die auf mehr als 65.536 Methoden verweisen, müssen Multidex-Konfigurationen verwenden. Weitere Informationen zur Verwendung von Multidex finden Sie unter Apps mit über 64.000 Methoden erstellen.

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

com.android.support:multidex:1.0.0

v7 Support Libraries

Diese Bibliotheken bieten bestimmte Funktionen und können unabhängig voneinander in Ihre Anwendung eingebunden werden.

v7 appcompat-Bibliothek   Teil von Android Jetpack.

Hinweis:Die AppCompat-Bibliothek wurde in die AndroidX-Bibliothek migriert, die eine Android Jetpack-Komponente ist. Demo-App „Sunflower“

Diese Bibliothek bietet Unterstützung für das Designmuster der Aktionsleiste. Diese Bibliothek bietet Unterstützung für die Implementierung von Material Design-Benutzeroberflächen.

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 – Bietet eine Implementierung des Benutzeroberflächenmusters für die Aktionsleiste. Weitere Informationen zur Verwendung der Aktionsleiste finden Sie im Entwicklerleitfaden zur 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 mit AppCompat-Thema verwendet werden kann.
  • ShareActionProvider: Fügt Unterstützung für eine standardisierte Freigabeaktion (z. B. E-Mail oder Posten in sozialen Netzwerken) hinzu, die in eine Aktionsleiste aufgenommen werden kann.

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

com.android.support:appcompat-v7:28.0.0

v7-CardView-Bibliothek

Diese Bibliothek bietet Unterstützung für das CardView-Widget, mit dem Sie Informationen in Karten mit einem einheitlichen Erscheinungsbild in jeder App anzeigen können. Diese Karten sind nützlich für die Implementierung von Material Design und werden häufig in Layouts für TV-Apps verwendet.

Die Gradle-Build-Skript-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 mit dieser Bibliothek Unterstützung für die Klasse GridLayout hinzugefügt, mit der Sie Benutzeroberflächenelemente in einem Raster aus rechteckigen Zellen anordnen können. 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-Skript-Abhängigkeits-ID für diese Bibliothek lautet:

com.android.support:gridlayout-v7:28.0.0

Mediarouter-Bibliothek für Version 7

Diese Bibliothek bietet MediaRouter, MediaRouteProvider und zugehörige Medienklassen, die Google Cast unterstützen.

Im Allgemeinen bieten die APIs in der Mediarouter-Bibliothek v7 eine Möglichkeit, das Routing von Media-Channels 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 app-spezifischen Media-Routenanbietern, zum Ermitteln und Auswählen von Zielgeräten, zum Prüfen des Media-Status und mehr. Ausführliche Informationen zu den APIs der Mediarouter-Bibliothek v7 finden Sie in der API-Referenz im Paket android.support.v7.media.

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

com.android.support:mediarouter-v7:28.0.0

Die in Support Library r18 eingeführten v7 mediarouter-Bibliotheks-APIs können sich in späteren Versionen der Support Library ändern. Derzeit empfehlen wir, die Bibliothek nur in Verbindung mit Google Cast zu verwenden.

v7-Palettenbibliothek

Die v7-Palette-Supportbibliothek enthält die Palette-Klasse, mit der Sie markante Farben aus einem Bild extrahieren können. Eine Musik-App könnte beispielsweise ein Palette-Objekt verwenden, um die wichtigsten Farben eines Albumcovers zu extrahieren und damit eine farblich abgestimmte Songtitelkarte zu erstellen.

Die Gradle-Build-Skript-Abhängigkeits-ID 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 bietet Unterstützung für das RecyclerView-Widget, eine Ansicht zum effizienten Anzeigen großer Datasets, indem ein begrenztes Fenster mit Datenelementen bereitgestellt wird.

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

com.android.support:recyclerview-v7:28.0.0

v7 Preference Support Library

Das preference-Paket bietet APIs zum Hinzufügen von Einstellungsobjekten wie CheckBoxPreference und ListPreference, damit Nutzer UI-Einstellungen ändern können.

Die v7-Einstellungsbibliothek bietet Unterstützung für Schnittstellen wie Preference.OnPreferenceChangeListener und Preference.OnPreferenceClickListener sowie für Klassen wie CheckBoxPreference und ListPreference.

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

com.android.support:preference-v7:28.0.0

v8 Support Library

Diese Bibliothek bietet bestimmte Funktionen und kann unabhängig von anderen Bibliotheken in Ihre Anwendung eingebunden werden.

v8-Renderscript-Bibliothek

Diese Bibliothek bietet Unterstützung für das RenderScript-Berechnungs-Framework. Diese APIs sind im Paket android.support.v8.renderscript enthalten. Die Schritte zum Einbinden dieser APIs in Ihre Anwendung unterscheiden sich erheblich von anderen Support-Bibliotheks-APIs. Weitere Informationen zur Verwendung dieser APIs in Ihrer Anwendung finden Sie im RenderScript-Entwicklerleitfaden.

Hinweis:Die Verwendung von RenderScript mit der Support-Bibliothek wird in Android Studio und bei Gradle-basierten Builds unterstützt. Die Renderscript-Bibliothek befindet sich im Ordner build-tools/$VERSION/renderscript/.

Im folgenden Beispiel sehen Sie die Eigenschaften des Gradle-Build-Skripts für diese Bibliothek:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Support Library – Version 13

Diese Bibliothek bietet Unterstützung für das UI-Muster Fragment mit der Klasse (FragmentCompat) und zusätzlichen Fragmentunterstützungsklassen. Weitere Informationen zu Fragmenten finden Sie im Entwicklerleitfaden zu Fragmenten. Ausführliche Informationen zu den v13 Support Library-APIs finden Sie in der API-Referenz im Paket android.support.v13.

Hinweis:Die Fragment-Bibliothek v4 bietet eine Fragment-Klasse. Die Klasse v4 Fragment ist eine eigenständige Klasse, die Fehlerkorrekturen enthält, die in späteren Plattformversionen hinzugefügt wurden. Die Klasse v13 FragmentCompat bietet Kompatibilitäts-Shims für die Framework-Implementierung der Klasse Fragment.

Die Gradle-Build-Skript-Abhängigkeits-ID 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 zum Hinzufügen von Unterstützung für Einstellungen wie PreferenceFragment.OnPreferenceStartFragmentCallback und PreferenceFragment.OnPreferenceStartScreenCallback sowie Klassen wie MultiSelectListPreference und PreferenceFragment. Ausführliche Informationen zu den v14 Preference Support Library-APIs finden Sie in der API-Referenz im Paket preference.

Die Gradle-Build-Skript-Abhängigkeits-ID 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 zum Bereitstellen von Einstellungen auf TV-Geräten, einschließlich Unterstützung für die Schnittstelle LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener und Klassen wie BaseLeanbackPreferenceFragment und LeanbackPreferenceFragment. Detaillierte Informationen zu den v17 Preference Support Library-APIs finden Sie in der API-Referenz im Paket preference.

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

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

Leanback-Mediathek v17

Das Paket android.support.v17.leanback bietet APIs zur Unterstützung der Entwicklung von Benutzeroberflächen auf TV-Geräten. Es bietet eine Reihe wichtiger Widgets für TV-Apps. Einige der wichtigsten Klassen sind:

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

com.android.support:leanback-v17:28.0.0

Vector Drawable Library

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

Bibliothek für animierte Vektor-Drawables

Bietet Unterstützung für animierte Vektorgrafiken.

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

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

Annotations Support Library

Das Paket Annotation bietet APIs zum Hinzufügen von Annotationsmetadaten zu Ihren Apps.

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

com.android.support:support-annotations:28.0.0

Design Support Library

Das Paket Design bietet APIs zum Hinzufügen von Material Design-Komponenten und -Mustern zu Ihren Apps.

Die Design Support-Bibliothek bietet Unterstützung für verschiedene Material Design-Komponenten und ‑Muster, die App-Entwickler nutzen können, z. B. Navigationsleisten, Floating Action Buttons (FABs), Snackbars und Tabs.

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

com.android.support:design:28.0.0

Support Library für benutzerdefinierte Tabs

Das Paket Benutzerdefinierte Tabs bietet APIs zum Hinzufügen und Verwalten benutzerdefinierter Tabs in Ihren Apps.

Die Custom Tabs Support-Bibliothek 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-Skript-Abhängigkeits-ID für diese Bibliothek lautet:

com.android.support:customtabs:28.0.0

Percent Support Library

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

Hinweis:Ab Version 26.0.0 wird die Percent Support Library nicht mehr unterstützt. Clients dieses Moduls sollten zum neuen Widget ConstraintLayout migrieren, das als separates Artefakt im SDK Manager verfügbar ist.

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

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

com.android.support:percent:28.0.0

ExifInterface Support Library

In Exif-Tags werden Informationen wie Ausrichtung, Datum und Uhrzeit, Kamerainformationen und der Standort direkt in einer JPEG- oder RAW-Datei gespeichert. Die Klasse ExifInterface entkoppelt die Unterstützung für 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 für JPEG-Bilddateien.

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

com.android.support:exifinterface:28.0.0

App Recommendation Support Library für TV

Das Paket App Recommendation bietet APIs zum Hinzufügen von Inhaltsempfehlungen in Ihrer App, die auf TV-Geräten ausgeführt wird.

Die App-Bibliothek bietet Unterstützung für 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-Skript-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 Support Library.

Weitere Informationen finden Sie unter Wear-UI-Bibliothek verwenden.

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

com.android.support:wear:28.0.0