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. Die 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 du die Android-Supportbibliotheken in deinem Entwicklungsprojekt einrichtest, hängt davon ab, welche Funktionen du verwenden möchtest und welche Android-Plattformversionen du mit deiner App unterstützen möchtest.

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 den SDK Manager wird nicht mehr unterstützt und diese Funktion wird bald entfernt.

Support Libraries auswählen

Bevor Sie Ihrer Anwendung eine Supportbibliothek hinzufügen, sollten Sie entscheiden, welche Funktionen Sie einbeziehen und welche niedrigsten Android-Versionen Sie unterstützen möchten. Weitere Informationen zu den Funktionen der verschiedenen Bibliotheken finden Sie unter Unterstützte Bibliotheksfunktionen.

Supportbibliotheken hinzufügen

Sie müssen die Klassenpfadabhängigkeiten des Projekts Ihrer Anwendung in Ihrer Entwicklungsumgebung ändern, um eine Supportbibliothek verwenden zu können. Sie müssen diesen Vorgang für jede Supportbibliothek ausführen, die Sie verwenden möchten.

So fügen Sie Ihrem Anwendungsprojekt eine Supportbibliothek hinzu:

1. Fügen Sie das Maven-Repository von Google in die settings.gradle-Datei 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 die Bibliothek für jedes Modul, in dem Sie eine Supportbibliothek verwenden möchten, in den Block dependencies der Datei build.gradle des Moduls ein. Wenn Sie beispielsweise die v4-core-utils-Bibliothek 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 der Regression führen. Wir empfehlen, eine Bibliotheksversion explizit anzugeben (z. B. palette-v7:28.0.0).

Support Library APIs verwenden

Supportbibliotheksklassen, 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 ein *Compat-Suffix.

Hinweis:Nachdem Sie die Supportbibliothek in Ihr Anwendungsprojekt aufgenommen haben, wird dringend empfohlen, die Anwendung für die Veröffentlichung zu verkleinern, zu verschleiern und zu optimieren. 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 wird die Downloadgröße Ihrer Anwendung so klein wie möglich gehalten.

Weitere Informationen zur Verwendung einiger Funktionen der Supportbibliothek finden Sie in den Trainingsklassen, Leitfäden 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 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, aktualisieren Sie das Manifest Ihrer Anwendung. Insbesondere solltest du das Element android:minSdkVersion des <uses-sdk>-Tags im Manifest wie unten gezeigt auf die neue, niedrigere Versionsnummer aktualisieren:

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

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

Wenn Sie Gradle-Builddateien verwenden, werden die Manifesteinstellungen durch die Einstellung minSdkVersion in der Builddatei überschrieben.

plugins {
  id 'com.android.application'
}

android {
    ...

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

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

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-Version mindestens 17 sein.