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 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 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

Wenn Sie eine Supportbibliothek verwenden möchten, müssen Sie die Pfadabhängigkeiten des Projekts Ihrer Anwendung in Ihrer Entwicklungsumgebung ändern. 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 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 Supportbibliothek verwenden möchten, die Bibliothek im Block dependencies der Datei build.gradle des Moduls hinzu. 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.

Achtung:Wenn Sie Klassen aus der Supportbibliothek verwenden, müssen Sie die Klasse aus dem entsprechenden Paket importieren. 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, empfehlen wir Ihnen dringend, Ihre App für die Veröffentlichung zu verkleinern, zu verschleieren 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 einbinden. So wird die Downloadgröße Ihrer Anwendung so klein wie möglich gehalten.

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 mit der Support Library auf eine frühere Version der Android API erhöhen, aktualisieren Sie das Manifest Ihrer Anwendung. 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" />

Die Manifesteinstellung teilt Google Play mit, dass Ihre 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 teilt die Build-Dateieinstellung Google Play mit, dass die Standard-Buildvariante Ihrer App auf Geräten mit Android 4.1 (API-Ebene 16) und höher installiert werden kann. Weitere Informationen zu Buildvarianten finden Sie unter Build-System – Übersicht.

Hinweis:Wenn Sie mehrere Supportbibliotheken einbinden, muss die Mindest-SDK-Version die höchste Version sein, die für eine 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 SDK-Version mindestens 17 sein.