Einrichtung der Bibliothek unterstützen

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

Sie können die Supportbibliothek weiterhin verwenden. Historische Artefakte (die Version 27 und frühere Versionen, die als android.support.* gepackt sind) werden weiterhin auf Google Maven verfügbar sind. Die Entwicklung neuer Bibliotheken in der AndroidX-Bibliothek enthalten.

Wir empfehlen, die AndroidX-Bibliotheken in allen neuen Projekten zu verwenden. Außerdem sollten Sie migrieren Sie ebenfalls vorhandene Projekte zu AndroidX.

Wie Sie die Android-Supportbibliotheken in Ihrem Entwicklungsprojekt einrichten, hängt davon ab, welche Funktionen welche Android-Plattformversionen ihr verwenden möchtet, .

In diesem Dokument erfahren Sie, wie Sie das Support Library-Paket herunterladen und Bibliotheken hinzufügen. für Ihre Entwicklungsumgebung.

Die Supportbibliotheken sind jetzt über Maven von Google verfügbar zu erstellen. Das Herunterladen der Bibliotheken über das SDK wird nicht mehr unterstützt und diese Funktion wird demnächst entfernt.

Supportbibliotheken auswählen

Entscheiden Sie, welche Funktionen Sie einbinden möchten, bevor Sie Ihrer Anwendung eine Supportbibliothek hinzufügen und die niedrigsten Android-Versionen, die unterstützt werden sollen. Weitere Informationen zu den Funktionen Bibliotheken bereitgestellt werden, finden Sie Funktionen der Supportbibliothek.

Supportbibliotheken hinzufügen

Um eine Support Library zu verwenden, müssen Sie das Projekt Ihrer Anwendung Klassenpfadabhängigkeiten innerhalb Ihrer Entwicklungsumgebung. Dieser Vorgang muss für Supportbibliotheken, die Sie verwenden möchten.

So fügen Sie Ihrem Anwendungsprojekt eine Supportbibliothek hinzu:

  1. Maven-Repository von Google in das settings.gradle-Datei. 
    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 Block dependencies der build.gradle-Datei des Moduls. Für Um die v4 Core-utils-Bibliothek hinzuzufügen, fügen Sie beispielsweise Folgendes hinzu: 
    dependencies {
    ...
    implementation "com.android.support:support-core-utils:28.0.0"
}

Achtung:Bei Verwendung dynamischer Abhängigkeiten (z. B. palette-v7:23.0.+) kann zu unerwarteten Versionsupdates und Regressionsinkompatibilitäten. Wir empfehlen, explizit eine Bibliotheksversion, 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 die denselben Namen wie die Framework-Klasse, befinden sich aber in den android.support-Klassenpaketen, oder das Suffix *Compat haben.

Achtung:Wenn Sie Klassen aus der Supportbibliothek verwenden, müssen Sie die Klasse aus dem entsprechenden Paket. Wenn Sie z. B. die ActionBar Klasse:

  • android.support.v7.app.ActionBar, wenn Sie die Supportbibliothek 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, sollten Sie unbedingt verkleinern, verschleiern und optimieren für die Veröffentlichung Ihrer App. Neben dem Schutz Ihres Quellcodes durch Verschleierung müssen Sie entfernt nicht verwendete Klassen aus allen Bibliotheken, die Sie in Ihre Anwendung aufnehmen. die Downloadgröße der App so klein wie möglich.

Weitere Informationen zur Verwendung einiger Funktionen der Supportbibliothek finden Sie in der Android-Entwicklerdokumentation Schulungen, Leitfäden und Beispiele. Weitere Informationen zu den einzelnen Klassen und Methoden der Support Library finden Sie unter android.support-Pakete in der API-Referenz

Änderungen der Manifestdeklaration

Wenn Sie die Abwärtskompatibilität Ihrer vorhandenen Anwendung auf eine frühere Version der Android API mit der Support Library abrufen, aktualisieren Sie die Manifests. Insbesondere müssen Sie die android:minSdkVersion aktualisieren des <uses-sdk> im Manifest an die neue, niedrigere Versionsnummer wie folgt an: (siehe unten):

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

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

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

plugins {
  id 'com.android.application'
}

android {
    ...

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

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

Hinweis: Wenn Sie mehrere Supportbibliotheken verwenden, gilt Folgendes: SDK-Mindestversion muss die höchste Version sein, die für eine der folgenden den angegebenen Bibliotheken. Wenn Ihre App beispielsweise die v14 Preference Support Library und die Leanback-Bibliothek Version 17, dein Minimum Die SDK-Version muss 17 oder höher sein.