Einrichtung der Bibliothek unterstützen

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

Sie können die Support-Bibliothek weiterhin verwenden. Bisherige Artefakte (Version 27 und früher, verpackt als android.support.*) sind weiterhin in 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 in Erwägung ziehen, 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 wird beschrieben, 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 den SDK Manager wird nicht mehr unterstützt und diese Funktion wird bald entfernt.

Support-Bibliotheken auswählen

Bevor Sie Ihrer Anwendung eine Support Library hinzufügen, müssen Sie entscheiden, 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 Support Library Features.

Supportbibliotheken hinzufügen

Wenn Sie eine Support-Bibliothek 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-Bibliothek hinzu:

1. Fügen Sie das Maven-Repository von Google in die Datei settings.gradle Ihres Projekts ein.

   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-Bibliothek verwenden möchten, die Bibliothek im dependencies-Block der build.gradle-Datei des Moduls hinzu. Wenn Sie beispielsweise die Core-Utils-Bibliothek v4 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 Versionsupdates und Inkompatibilitäten bei Regressionen führen. Wir empfehlen, explizit eine Bibliotheksversion 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 Klassenpaketen android.support oder haben das Suffix *Compat.

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. Neben dem Schutz Ihres Quellcodes durch Verschleierung werden durch die Reduzierung nicht verwendete Klassen aus allen Bibliotheken entfernt, die Sie in Ihre Anwendung einbinden. So wird die Downloadgröße Ihrer Anwendung so gering wie möglich gehalten.

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

Änderungen bei der Manifestdeklaration

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

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

Mit dieser Manifesteinstellung wird Google Play mitgeteilt, dass Ihre App 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 wird Google Play durch die Einstellung in der Build-Datei mitgeteilt, dass die Standard-Build-Variante Ihrer Anwendung auf Geräten mit Android 4.1 (API-Ebene 16) und höher installiert werden kann. Weitere Informationen zu Build-Varianten finden Sie unter Übersicht über das Build-System.

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