Migration für Android Consumer SDK Version 2.0.0

Aktualisierungen von Gradle und dem Android-Gradle-Plug-in

Gradle- und Android-Gradle-Plug-in-Versionen aktualisieren

Führen Sie zuerst ein Upgrade der Gradle- und Android-Gradle-Plug-in-Versionen durch. Dieses Upgrade bietet eine bessere Kompatibilität mit bestimmten SDK-Abhängigkeiten (einschließlich Kotlin 1.9) sowie einige wichtige Fehlerkorrekturen.

Für diese Hauptversion des SDK sind die folgenden Versionsabhängigkeiten für Ihr Android-Anwendungsprojekt erforderlich:

• eine Gradle-Version von mindestens 7.5.0, aber nicht höher als 7.6.0.
• ein Android-Gradle-Plug-in (AGP) der Version 7.4.x

Sie können eine höhere Version der Plug-ins anvisieren. Möglicherweise erhalten Sie jedoch Warnungen zur Einstellung oder einige neue Funktionen funktionieren nicht.

Wenn Sie die Gradle-Version ändern möchten, ändern Sie die Zeile in der /gradle/wrapper/gradle-wrapper.properties-Datei Ihres Projekts.

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip

Wenn Sie die Version des Android-Gradle-Plug-ins ändern möchten, ändern Sie die Datei build.gradle, die den Block buildscript enthält. Beispiel:

buildscript {
    repositories {
        google()
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

Migration der Bibliotheksunterstützung von Java 7 zu Java 8

Schritt 1: Unterstützung für Java 8-Bibliothek aktivieren

Quelle

Da das minimale API-Level des SDK 23 ist und die erforderliche AGP-Version 7.4 oder höher ist, unterscheidet sich die Konfiguration geringfügig von der genannten Quelldokumentation.

buildscript {

    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            url = uri("https://storage.googleapis.com/r8-releases/raw")
        }
    }
    dependencies {
        classpath 'com.android.tools:r8:8.0.46'
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

android {
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.3'
}

Hinweis: Mit diesem Script wird nicht nur die Unterstützung von Java 8-Bibliotheken aktiviert, sondern auch die Unterstützung der Desugaring von Java 8- und höher-Bibliotheken. Beide sind für die Verwendung der neuesten Consumer- und Driver SDKs erforderlich.

Schritt 2: Von ProGuard oder Dexguard zu R8 migrieren

R8, Quelle

AGP v7.4 und höher verwendet R8 als Standard-Tool zum Schrumpfen, Verschleieren und Optimieren der Binärdatei. Daher sind derzeit keine besonderen Maßnahmen erforderlich.

Wenn das Projekt von AGP 4.0 oder höher migriert wird, werden in AGP möglicherweise die folgenden Warnungen zu Dateientfernungen ausgegeben:

• useProguard true-Nutzung in der build.gradle-Datei
• android.enableR8=false-Nutzung in der gradle.properties-Datei

In der Regel lassen sich diese Probleme durch Entfernen dieser Zeilen beheben.

Migration von Kotlin 1.6 auf 1.9

Schritt 1: Zum Kotlin Gradle-Plug-in 1.9.0 migrieren

Quelle

Aktualisieren Sie die Version des Kotlin-Gradle-Plug-ins in der Datei „build.gradle“ des Moduls auf der obersten Ebene Ihrer Anwendung. Fügen Sie org.jetbrains.kotlin:kotlin-gradle-plugin gegebenenfalls den Abhängigkeiten aus dem Block „buildscript“ hinzu.

buildscript {
  dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
  }
}

Wenn Sie das Kotlin Gradle-Plug-in 1.6.X oder 1.7.X verwenden, müssen Sie Ihre Anwendung von Kotlin-Synthesen migrieren. Weitere Informationen finden Sie in der offiziellen Migrationsanleitung.

Schritt 2: kotlin-stdlib auf Version 1.9.0 aktualisieren

Quelle

Aktualisieren Sie kotlin-stblib in der Datei „build.gradle“ Ihrer Anwendung auf 1.9.0.

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
}

Entfernen Sie alle Verweise auf kotlin-stdlib-jdk7 oder kotlin-stdlib-jdk8. Beide Abhängigkeiten wurden ab Kotlin 1.8.0 in kotlin-stdlib zusammengeführt.