Hinweis: Mit der Veröffentlichung der Support Library 28.0.0 sind die Bibliotheken mit dem Paket android.support veraltet und werden durch Jetpack-Bibliotheken mit individueller Versionsnummer ersetzt, die als androidx verpackt sind. Die erste Version 1.0.0
der Jetpack-Bibliotheken entspricht der Support Library 28.0.0 und bietet einen
Ausgangspunkt für die Migration zur neuen androidx
Verpackung.
Die vorhandenen Bibliotheken mit dem Paket android.support funktionieren weiterhin, erhalten aber
keine Updates mehr über Version 28.0.0 hinaus und sind nicht mit neuen Jetpack-Bibliotheken kompatibel.
Ältere Artefakte (Version 27 und früher, verpackt als android.support)
sind weiterhin auf 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, vorhandene Projekte zu migrieren, damit sie
weiterhin Fehlerkorrekturen und andere Verbesserungen der Bibliothek erhalten.
Die Android Support Library enthält mehrere Bibliothekspakete, die in Ihre Anwendung eingebunden werden können. Jede dieser Bibliotheken unterstützt einen bestimmten Bereich von Android-Plattform Versionen 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 Libraries unter Support Library Setup um diesen Schritt auszuführen. Sie müssen zusätzliche Schritte ausführen, um eine bestimmte Support Library in Ihre Anwendung einzubinden. Am Ende jedes Bibliotheksabschnitts finden Sie wichtige Informationen dazu, wie Sie die Bibliothek in Ihre Anwendung einbinden.
Hinweis:Die mindestens erforderliche SDK-Version für alle Support Library-Pakete ist mindestens API-Level 14. Für einige Pakete ist ein höheres API-Level erforderlich, wie unten angegeben.
v4 Support Libraries
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, Datenverarbeitung, Netzwerkverbindungen und Programmier Dienstprogramme.
Vollständige und detaillierte Informationen zu den Klassen und Methoden, die von
den v4 Support Libraries bereitgestellt werden, finden Sie im android.support.v4 Paket in der API-Referenz.
Hinweis: Vor der Support Library-Version 24.2.0 gab es nur eine
v4 Support Library. Diese Bibliothek wurde in mehrere Module unterteilt, um
die Effizienz zu verbessern. Aus Gründen der Abwärtskompatibilität enthält Ihre App alle v4-Module, wenn Sie
support-v4 in Ihrem Gradle-Skript auflisten. Um die App-Größe zu reduzieren, empfehlen wir jedoch, nur die spezifischen Module aufzulisten,
die Ihre App benötigt.
v4 compat library
Bietet Kompatibilitäts-Wrapper für eine Reihe von Framework-APIs wie
Context.obtainDrawable() und
View.performAccessibilityAction().
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:support-core-ui:28.0.0
v4 media-compat library
Backports-Teile des Media Framework,
einschließlich MediaBrowser und MediaSession.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:support-media-compat:28.0.0
v4 fragment library
Fügt Unterstützung für die Kapselung von Benutzeroberfläche und Funktionalität mit Fragmenten, hinzu, sodass Anwendungen Layouts bereitstellen können, die sich an kleine und große Bildschirme anpassen. Dieses Modul hat Abhängigkeiten von compat, core-utils, core-ui und media-compat.
Hinweis: Die v13 Support Library
bietet eine FragmentCompat Klasse. Die v4
Fragment Klasse ist eine eigenständige Klasse, die
Fehlerkorrekturen bietet, die in späteren Plattformversionen hinzugefügt wurden. Die
v13 FragmentCompat Klasse bietet
Kompatibilitäts-Shims für die Framework-Implementierung der
Fragment Klasse.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:support-fragment:28.0.0
Multidex Support Library
Diese Bibliothek bietet Unterstützung für das Erstellen von Apps mit mehreren DEX-Dateien (Dalvik Executable). Für Apps, die mehr als 65.536 Methoden referenzieren, sind Multidex-Konfigurationen erforderlich. Weitere Informationen zur Verwendung von Multidex finden Sie unter Apps mit mehr als 64.000 Methoden erstellen.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:multidex:1.0.0
v7 Support Libraries
Diese Bibliotheken bieten bestimmte Funktionssätze und können unabhängig voneinander in Ihre Anwendung eingebunden werden.
v7 appcompat library Teil von Android Jetpack.
Hinweis:Die appcompat library wurde in die AndroidX library migriert, die eine Android Jetpack-Komponente ist. Sie können sie in der Sunflower-Demo-App in Aktion sehen.
Diese Bibliothek fügt Unterstützung für das Aktionsleiste Benutzeroberfläche design pattern hinzu. Diese Bibliothek bietet Unterstützung für Implementierungen der Benutzeroberfläche im Material Design.
Hinweis: Diese Bibliothek ist von der v4 Support Library abhängig.
Hier sind einige der wichtigsten Klassen, die in der v7 appcompat library enthalten sind:
ActionBar: Bietet eine Implementierung des Benutzeroberflächendesignmusters der Aktionsleiste . Weitere Informationen zur Verwendung der Aktionsleiste finden Sie im Aktionsleiste Entwicklerleitfaden.AppCompatActivity: Fügt eine Anwendungsklasse für Aktivitäten 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 AppCompat-Dialoge 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 eingebunden werden kann.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:appcompat-v7:28.0.0
v7 cardview library
Diese Bibliothek fügt Unterstützung für das CardView-Widget hinzu, mit dem Sie Informationen in Karten anzeigen können, die in jeder App ein einheitliches Erscheinungsbild haben. Diese Karten sind nützlich für Implementierungen im Material Design und werden häufig in Layouts für TV-Apps verwendet.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:cardview-v7:28.0.0
v7 gridlayout library
Nachdem Sie die Android Support Libraries heruntergeladen haben, fügt diese Bibliothek Unterstützung für die Klasse GridLayout hinzu, mit der Sie Benutzeroberflächenelemente mithilfe eines Rasters aus rechteckigen Zellen anordnen können.
Detaillierte Informationen zu den APIs der v7 gridlayout library finden Sie im Paket android.support.v7.widget in der API-Referenz.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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 v7 mediarouter library 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 anwendungsspezifischen Media Route-Anbietern, zum Erkennen und Auswählen von Zielgeräten, zum Prüfen des Medienstatus und mehr. Detaillierte Informationen zu den APIs der v7 mediarouter library finden Sie im Paket android.support.v7.media in der API-Referenz.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:mediarouter-v7:28.0.0
Die APIs der v7 mediarouter library, die in der Support Library r18 eingeführt wurden, können sich in späteren Revisionen der Support Library ändern. Derzeit empfehlen wir, die Bibliothek nur in Verbindung mit Google Cast zu verwenden.
v7 palette library
Die v7 palette support library enthält die Klasse Palette, mit der Sie markante 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 diese Farben zu verwenden, um eine farblich abgestimmte Songtitelkarte zu erstellen.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:palette-v7:28.0.0
v7 recyclerview library
Die recyclerview library fügt die Klasse RecyclerView hinzu. Diese Klasse bietet Unterstützung für das
RecyclerView
-Widget, eine Ansicht zum effizienten Anzeigen großer Datensätze, indem ein
begrenztes Fenster mit Datenelementen bereitgestellt wird.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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, damit
Nutzer UI-Einstellungen ändern können.
Die v7 Preference Library fügt Unterstützung für Schnittstellen wie Preference.OnPreferenceChangeListener und Preference.OnPreferenceClickListener sowie für Klassen wie CheckBoxPreference und ListPreference hinzu.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:preference-v7:28.0.0
v8 Support Library
Diese Bibliothek bietet bestimmte Funktionssätze und kann unabhängig von anderen Bibliotheken in Ihre Anwendung eingebunden werden.
v8 renderscript library
Diese Bibliothek fügt Unterstützung für
das RenderScript Berechnungs
framework hinzu. Diese APIs sind im Paket android.support.v8.renderscript enthalten. Sie
sollten sich bewusst sein, dass sich die Schritte zum Einbinden dieser APIs in Ihre Anwendung sehr
von denen für andere Support Library-APIs unterscheiden. Weitere Informationen zur Verwendung dieser APIs
in Ihrer Anwendung finden Sie im
RenderScript
Entwicklerleitfaden.
Hinweis: Die Verwendung von RenderScript mit der Support Library wird mit Android
Studio und Gradle-basierten Builds unterstützt. Die
renderscript library befindet sich im build-tools/$VERSION/renderscript/ Ordner.
Das folgende Beispiel zeigt die Eigenschaften des Gradle-Build-Skripts für diese Bibliothek:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
v13 Support Library
Diese Bibliothek fügt Unterstützung
für das Fragment Benutzeroberflächendesignmuster
mit der Klasse (FragmentCompat) und zusätzlichen Fragment-Support
Klassen hinzu. Weitere Informationen zu Fragmenten finden Sie im
Entwicklerleitfaden zu Fragmenten. Detaillierte
Informationen zu den APIs der v13 Support Library finden Sie im android.support.v13 Paket in der API-Referenz.
Hinweis: Die v4 fragment library
bietet eine Fragment Klasse. Die v4
Fragment Klasse ist eine eigenständige Klasse, die
Fehlerkorrekturen bietet, die in späteren Plattformversionen hinzugefügt wurden. Die
v13 FragmentCompat Klasse bietet
Kompatibilitäts-Shims für die Framework-Implementierung der
Fragment Klasse.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:support-v13:28.0.0
v14 Preference Support Library
Das android.support.v14.preference Paket bietet APIs zum Hinzufügen von Unterstützung
für Einstellungsschnittstellen wie
PreferenceFragment.OnPreferenceStartFragmentCallback
und
PreferenceFragment.OnPreferenceStartScreenCallback,
sowie für Klassen wie
MultiSelectListPreference und
PreferenceFragment. Detaillierte
Informationen zu den APIs der v14 Preference Support Library finden Sie im
Paket „preference“
in der API-Referenz.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:preference-v14:28.0.0
v17 Preference Support Library for TV
Das android.support.v17.preference Paket bietet APIs zum Bereitstellen von Einstellungsschnittstellen auf TV-Geräten, einschließlich Unterstützung für die
LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
Schnittstelle und Klassen wie
BaseLeanbackPreferenceFragment und
LeanbackPreferenceFragment. Detaillierte
Informationen zu den APIs der v17 Preference Support Library finden Sie im
Paket „preference“
in der API-Referenz.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:preference-leanback-v17:28.0.0
v17 Leanback Library
Das Paket android.support.v17.leanback bietet APIs zum Erstellen von Benutzeroberflächen auf TV-Geräten. Es bietet eine Reihe wichtiger Widgets für TV-Apps. Einige der wichtigsten Klassen sind:
BrowseFragment: Ein Fragment zum Erstellen eines primären Layouts zum Durchsuchen von Kategorien und Zeilen mit Medienelementen.DetailsFragment: Ein Wrapper Fragment für Leanback-Detailbildschirme.PlaybackOverlayFragment: Eine abgeleitete Klasse vonDetailsFragmentzum Anzeigen von Wiedergabesteuerung und zugehörigen Inhalten.SearchFragment: Ein Fragment zum Verarbeiten von Suchanfragen. Das Fragment empfängt die Suchanfrage des Nutzers und übergibt es an den von der Anwendung bereitgestelltenSearchResultProvider. DerSearchResultProvidergibt die Suchergebnisse an dasSearchFragmentzurück, das sie in einemRowsFragmentrendert.
Für dieses Paket ist API-Level 17 oder höher erforderlich. Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:leanback-v17:28.0.0
Vector Drawable Library
Bietet Unterstützung für statische Vektorgrafiken.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:support-vector-drawable:28.0.0
Animated Vector Drawable Library
Bietet Unterstützung für animierte Vektorgrafiken.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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 Library fügt Unterstützung für verschiedene Material Design-Komponenten und -Muster hinzu, auf denen App-Entwickler aufbauen können, z. B. Navigationsleisten, Floating Action Buttons (FAB), Snackbars und Tabs.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:design:28.0.0
Custom Tabs Support Library
Das Paket „Custom Tabs“ bietet APIs zum Hinzufügen und Verwalten benutzerdefinierter Tabs in Ihren Apps.
Die Custom Tabs Support Library fügt Unterstützung für verschiedene Klassen wie Custom Tabs Service und Custom Tabs Callbackhinzu.
Für dieses Paket ist API-Level 15 oder höher erforderlich. Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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 prozentualer Dimensionen in Ihrer App.
Hinweis:Ab Version 26.0.0 ist die Percent Support Library veraltet.
Kunden dieses Moduls sollten zum neuen ConstraintLayout
Widget migrieren, das als separates Artefakt im SDK Manager bereitgestellt wird.
Die Percent Support Library fügt Unterstützung für die Schnittstelle PercentLayoutHelper.PercentLayoutParams und verschiedene Klassen wie PercentFrameLayout und PercentRelativeLayouthinzu.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript 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, Kamera
Informationen und Standort direkt in einer JPEG- oder RAW-Datei gespeichert. Die ExifInterface
Klasse bietet 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) formatierten
Dateien und das Festlegen der Exif-Informationen für JPEG-Bilddateien.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:exifinterface:28.0.0
App Recommendation Support Library for 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 Library fügt Unterstützung für Annotationen wie ContentRecommendation.ContentMaturity und verschiedene Klassen wie ContentRecommendation und RecommendationExtender hinzu.
Für dieses Paket ist API-Level 21 oder höher erforderlich. Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:recommendation:28.0.0
Wear UI Library
Diese Bibliothek enthält APIs zum Erstellen von Benutzeroberflächen für Wear-Apps. Die APIs, die im android.support.wear.widget Paket verfügbar sind, ersetzen die entsprechenden APIs in der Wearable Support Library.
Weitere Informationen finden Sie unter Wear UI Library verwenden.
Der Abhängigkeitsbezeichner für das Gradle-Build-Skript für diese Bibliothek lautet:
com.android.support:wear:28.0.0