Einrichtung der Bibliothek unterstützen

Hinweis: Mit der Veröffentlichung von Android 9.0 (API-Ebene 28) gibt es eine neue Version der Supportbibliothek namens AndroidX, die Teil von Jetpack ist. AndroidX-Bibliothek enthält die vorhandene Supportbibliothek und die neuesten Jetpack-Komponenten.

Sie können die Supportbibliothek weiterhin verwenden. Bisherige Artefakte (Version 27 und niedriger, als android.support.* verpackt) sind weiterhin bei Google Maven verfügbar. Alle neuen Bibliotheken werden jedoch in der AndroidX-Bibliothek entwickelt.

Wir empfehlen, die AndroidX-Bibliotheken in allen neuen Projekten zu verwenden. Sie sollten auch überlegen, vorhandene Projekte zu AndroidX zu migrieren.

Wie Sie die Android-Supportbibliotheken in Ihrem Entwicklungsprojekt einrichten, hängt davon ab, welche Funktionen Sie verwenden möchten und welche Android-Plattformversionen Sie mit Ihrer Anwendung unterstützen möchten.

In diesem Dokument erfahren Sie, wie Sie das Support Library-Paket herunterladen und Ihrer Entwicklungsumgebung Bibliotheken hinzufügen.

Die Supportbibliotheken sind jetzt über das Maven-Repository von Google verfügbar. Das Herunterladen der Bibliotheken über das SDK wird nicht mehr unterstützt und diese Funktion wird demnächst entfernt.

Supportbibliotheken auswählen

Entscheiden Sie, welche Funktionen Sie aufnehmen möchten, bevor Sie Ihrer Anwendung eine Support Library hinzufügen. und die niedrigsten Android-Versionen, die Sie unterstützen möchten. Weitere Informationen zu den Funktionen Bibliotheken bereitgestellt werden, finden Sie Funktionen der Supportbibliothek.

Supportbibliotheken hinzufügen

Um eine Support Library zu verwenden, müssen Sie das Projekt Ihrer Anwendung Klassenpfadabhängigkeiten innerhalb Ihrer Entwicklungsumgebung. Dieser Vorgang muss für Supportbibliotheken, die Sie verwenden möchten.

So fügen Sie Ihrem Anwendungsprojekt eine Supportbibliothek hinzu:

  1. Maven-Repository von Google in das settings.gradle-Datei.
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
    
            // If you're using a version of Gradle lower than 4.1, you must
            // instead use:
            //
            // maven {
            //     url 'https://maven.google.com'
            // }
        }
    }
  2. Fügen Sie für jedes Modul, in dem Sie eine Supportbibliothek verwenden möchten, die Bibliothek im Block dependencies der build.gradle-Datei des Moduls hinzu. Für Um die v4 Core-utils-Bibliothek hinzuzufügen, fügen Sie beispielsweise Folgendes hinzu:
    dependencies {
        ...
        implementation "com.android.support:support-core-utils:28.0.0"
    }

Achtung: Die Verwendung dynamischer Abhängigkeiten (z. B. palette-v7:23.0.+) kann zu unerwarteten Versionsupdates und Inkompatibilitäten bei der Regression führen. Wir empfehlen, explizit eine Bibliotheksversion, z. B. palette-v7:28.0.0.

Support Library APIs verwenden

Support Library-Klassen, die Unterstützung für vorhandene Framework-APIs bieten, haben in der Regel die denselben Namen wie die Framework-Klasse, befinden sich aber in den android.support-Klassenpaketen, oder das Suffix *Compat haben.

Achtung:Wenn Sie Klassen aus der Supportbibliothek verwenden, müssen Sie die Klasse aus dem entsprechenden Paket. Beispiel für die Anwendung der Klasse ActionBar:

  • android.support.v7.app.ActionBar, wenn Sie die Support Library verwenden.
  • android.app.ActionBar, wenn Sie nur für API-Level 11 oder höher entwickeln.

Hinweis:Nachdem Sie die Supportbibliothek in Ihr Anwendungsprojekt aufgenommen haben, sollten Sie unbedingt verkleinern, verschleiern und optimieren für die Veröffentlichung Ihrer App. Neben dem Schutz Ihres Quellcodes durch Verschleierung werden durch die Komprimierung nicht verwendete Klassen aus allen Bibliotheken entfernt, die Sie in Ihre Anwendung aufnehmen. So bleibt die Downloadgröße Ihrer Anwendung so klein wie möglich.

Weitere Informationen zur Verwendung einiger Funktionen der Support Library finden Sie in den Schulungen, Anleitungen und Beispielen für Android-Entwickler. Weitere Informationen zu den einzelnen Klassen und Methoden der Support Library finden Sie in der API-Referenz unter android.support.

Änderungen an der Manifesterklärung

Wenn Sie die Abwärtskompatibilität Ihrer vorhandenen Anwendung auf eine frühere Version der Android API mit der Support Library abrufen, aktualisieren Sie die Manifests. Aktualisieren Sie insbesondere das android:minSdkVersion-Element des <uses-sdk>-Tags im Manifest auf die neue, niedrigere Versionsnummer, wie unten dargestellt:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Über die Manifesteinstellung wird Google Play mitgeteilt, dass Ihre App auf Geräten mit Android-Geräten installiert werden kann. 4.0 (API-Level 14) und höher.

Wenn Sie Gradle-Build-Dateien verwenden, ist die Einstellung minSdkVersion in der Build-Datei überschreibt die Manifest-Einstellungen.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

In diesem Fall wird Google Play durch die Einstellung für die Build-Datei mitgeteilt, App kann auf Geräten mit Android 4.1 (API-Level 16) und höher installiert werden. Weitere Informationen Informationen zu Build-Varianten finden Sie unter Build-System – Übersicht.

Hinweis: Wenn Sie mehrere Supportbibliotheken verwenden, gilt Folgendes: SDK-Mindestversion muss die höchste Version sein, die für eine der folgenden den angegebenen Bibliotheken. Wenn Ihre App beispielsweise die v14 Preference Support Library und die Leanback-Bibliothek Version 17, dein Minimum Die SDK-Version muss 17 oder höher sein.