Einrichtung der Bibliothek unterstützen

Hinweis:Mit der Veröffentlichung von Android 9.0 (API-Level 28) wurde eine neue Version der Supportbibliothek namens AndroidX veröffentlicht, die Teil von Jetpack ist. Die AndroidX-Bibliothek enthält die vorhandene Supportbibliothek sowie die neuesten Jetpack-Komponenten.

Sie können die Supportbibliothek weiterhin nutzen. Historische Artefakte (Version 27 und älter und als android.support.* verpackt) bleiben in Google Maven verfügbar. Die Entwicklung neuer Bibliotheken erfolgt jedoch vollständig in der AndroidX-Bibliothek.

Wir empfehlen, die AndroidX-Bibliotheken in allen neuen Projekten zu verwenden. Sie sollten auch die Migration vorhandener Projekte zu AndroidX in Betracht ziehen.

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

Supportbibliotheken auswählen

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

Supportbibliotheken hinzufügen

Wenn Sie eine Supportbibliothek verwenden möchten, müssen Sie die Klassenpfadabhängigkeiten Ihrer Anwendung innerhalb 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üge das Maven-Repository von Google in die Datei settings.gradle deines 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 in den Block dependencies der Datei build.gradle des Moduls ein. Wenn Sie beispielsweise die Core-utils-Bibliothek von 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 Versionsaktualisierungen und Regressionsinkompatibilitäten führen. Wir empfehlen, explizit eine Bibliotheksversion 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, empfehlen wir dringend, Ihre App zu verkleinern, zu verschleiern und für die Veröffentlichung zu optimieren. Durch das Kürzen wird nicht nur der Quellcode geschützt, sondern auch nicht verwendete Klassen aus allen Bibliotheken entfernt, die Sie in Ihre Anwendung aufnehmen. Dadurch bleibt die Downloadgröße Ihrer Anwendung so klein wie möglich.

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

Änderungen der Manifestdeklaration

Wenn du die Abwärtskompatibilität deiner vorhandenen App mithilfe der Support Library auf eine frühere Version der Android API erhöhen möchtest, musst du das Manifest deiner App aktualisieren. Insbesondere solltest du das android:minSdkVersion-Element des <uses-sdk>-Tags im Manifest auf die neue, niedrigere Versionsnummer aktualisieren, wie unten gezeigt:

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

Über die Manifesteinstellung weiß Google Play, dass deine 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 über die Einstellung für die Build-Datei mitgeteilt, dass die Standard-Build-Variante Ihrer App auf Geräten mit Android 4.1 (API-Level 16) und höher installiert werden kann. Weitere Informationen zu Build-Varianten findest du in der Übersicht zu Build-Systemen.

Hinweis:Wenn Sie mehrere Supportbibliotheken verwenden, muss die SDK-Mindestversion die höchste Version sein, die für eine der angegebenen Bibliotheken erforderlich ist. Wenn Ihre App beispielsweise sowohl die Einstellungsunterstützung für v14 als auch die Leanback-Bibliothek v17 enthält, muss die SDK-Mindestversion 17 oder höher sein.