Einrichtung der Bibliothek unterstützen

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

Sie können die Support Library weiterhin verwenden. Ältere Artefakte (Version 27 und früher, verpackt als android.support.*) sind weiterhin auf Google Maven verfügbar. Alle neuen Bibliotheken werden jedoch in der AndroidX Library entwickelt.

Wir empfehlen, die AndroidX Libraries in allen neuen Projekten zu verwenden. Sie sollten auch in Betracht ziehen, vorhandene Projekte zu AndroidX zu migrieren.

Wie Sie die Android Support Libraries 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 wird beschrieben, wie Sie das Support Library-Paket herunterladen und Bibliotheken zu Ihrer Entwicklungsumgebung hinzufügen.

Die Support Libraries sind jetzt über das Maven Repository von Google verfügbar. Das Herunterladen der Bibliotheken über den SDK Manager wird nicht mehr unterstützt und die Funktion wird bald entfernt.

Support Libraries auswählen

Bevor Sie Ihrer Anwendung eine Support Library hinzufügen, entscheiden Sie, welche Funktionen Sie einbinden möchten und welche Android-Mindestversionen Sie unterstützen möchten. Weitere Informationen zu den Funktionen der verschiedenen Bibliotheken finden Sie unter Funktionen der Support Library.

Support Libraries hinzufügen

Wenn Sie eine Support Library verwenden möchten, müssen Sie die Classpath-Abhängigkeiten des Projekts Ihrer Anwendung in Ihrer Entwicklungsumgebung ändern. Sie müssen diesen Vorgang für jede Support Library ausführen, die Sie verwenden möchten.

So fügen Sie Ihrem Anwendungsprojekt eine Support Library hinzu:

  1. Fügen Sie das Maven-Repository von Google der Datei settings.gradle Ihres Projekts hinzu. 
    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 Support Library verwenden möchten, die Bibliothek im dependencies Block der Datei build.gradle des Moduls hinzu. Wenn Sie beispielsweise die Bibliothek „v4 core-utils“ hinzufügen möchten, fügen Sie 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 Versionsaktualisierungen und Inkompatibilitäten führen. Wir empfehlen, eine Bibliotheksversion explizit anzugeben (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 denselben Namen wie die Framework-Klasse, befinden sich aber in den android.support Klassenpaketen oder haben das *Compat Suffix.

Achtung: Wenn Sie Klassen aus der Support Library verwenden, müssen Sie die Klasse aus dem entsprechenden Paket importieren. Beispiel: Wenn Sie die ActionBar Klasse anwenden:

  • android.support.v7.app.ActionBar bei Verwendung der Support Library.
  • android.app.ActionBar bei der Entwicklung nur für API-Level 11 oder höher.

Hinweis: Nachdem Sie die Support Library in Ihr Anwendungsprojekt aufgenommen haben, empfehlen wir dringend, Ihre App für die Veröffentlichung zu verkleinern, zu verschleiern und zu optimieren . Durch die Verschleierung wird nicht nur Ihr Quellcode geschützt, sondern durch das Verkleinern werden auch nicht verwendete Klassen aus allen Bibliotheken entfernt, die Sie in Ihre Anwendung einbinden. 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 Android-Entwickler schulungen, anleitungen und -beispielen. Weitere Informationen zu den einzelnen Klassen und Methoden der Support Library finden Sie in der API-Referenz unter den android.support Paketen.

Änderungen an der Manifestdeklaration

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

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

Die Manifesteinstellung teilt Google Play mit, dass Ihre Anwendung auf Geräten mit Android 4.0 (API-Level 14) und höher installiert werden kann.

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

plugins {
  id 'com.android.application'
}

android {
    ...

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

In diesem Fall teilt die Einstellung in der Build-Datei Google Play mit, dass die Standard-Build-Variante Ihrer Anwendung auf Geräten mit Android 4.1 (API-Level 16) und höher installiert werden kann. Weitere Informationen zu Build-Varianten finden Sie unter Übersicht über das Build-System.

Hinweis: Wenn Sie mehrere Support Libraries einbinden, muss die Mindest-SDK-Version die höchste Version sein, die von einer der angegebenen Bibliotheken erforderlich ist. Wenn Ihre App beispielsweise sowohl die v14 Preference Support Library als auch die v17 Leanback Library enthält, muss die Mindest SDK-Version 17 oder höher sein.