Migracja dla pakietu Android Consumer SDK w wersji 2.0.0

Aktualizacje Gradle i wtyczki Androida do obsługi Gradle

Uaktualnianie wersji Gradle i wtyczki Androida do obsługi Gradle

Najpierw zaktualizuj wersje Gradle i wtyczki Androida do obsługi Gradle. Ta aktualizacja zapewnia lepszą zgodność z niektórymi zależnościami pakietu SDK (w tym Kotlinem 1.9) oraz zawiera ważne poprawki błędów.

Ta główna wersja pakietu SDK wymaga w projekcie aplikacji na Androida tych zależności wersji:

  • wersję Gradle co najmniej 7.5.0, ale nie nowszą niż 7.6.0;
  • wersję wtyczki Androida do obsługi Gradle (AGP) z zakresu v7.4.x.

Możesz kierować reklamy na wyższą wersję wtyczek, ale mogą pojawić się ostrzeżenia o wycofaniu lub niektóre nowe funkcje mogą nie działać.

Aby zmodyfikować wersję Gradle, zmień wiersz w pliku /gradle/wrapper/gradle-wrapper.properties projektu.

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

Aby zmodyfikować wersję wtyczki Androida do obsługi Gradle, zmień plik build.gradle, który zawiera blok buildscript. Na przykład:

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

Migracja z bibliotek Java 7 na biblioteki Java 8

Krok 1. Włącz obsługę biblioteki Java 8

Źródło

Minimalny poziom interfejsu API pakietu SDK to 23, a wymagana wersja AGP to 7.4 lub nowsza, więc konfiguracja nieco różni się od tej podanej w dokumentacji źródłowej.

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

Krok 2. Przejdź z ProGuarda lub DexGuarda na R8

R8, źródło

AGP w wersji 7.4 i nowszych używa R8 jako domyślnego narzędzia do zmniejszania, zaciemniania i optymalizacji plików binarnych, więc na tym etapie nie musisz podejmować żadnych specjalnych działań.

Jeśli projekt został przeniesiony z AGP 4.0 lub nowszej wersji, AGP może wyświetlić te ostrzeżenia o usunięciu plików:

  • useProguard true w pliku build.gradle
  • android.enableR8=false w pliku gradle.properties

Usunięcie tych wierszy zwykle rozwiązuje te problemy.

Migracja z Kotlin 1.6 na 1.9

Krok 1. Przejdź na wtyczkę Kotlin Gradle w wersji 1.9.0

Źródło

Zaktualizuj wersję wtyczki Kotlin Gradle w pliku build.gradle modułu najwyższego poziomu aplikacji. Jeśli brakuje zależności, dodaj org.jetbrains.kotlin:kotlin-gradle-plugin w bloku buildscript.

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

Jeśli korzystasz z wtyczki Kotlin Gradle w wersji 1.6.X lub 1.7.X, musisz przenieść aplikację z Kotlin-synthetics. Więcej informacji znajdziesz w oficjalnym przewodniku po migracji.

Krok 2. Uaktualnij kotlin-stdlib do wersji 1.9.0

Źródło

Zaktualizuj kotlin-stblib do wersji 1.9.0 w pliku build.gradle aplikacji.

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

Usuń wszystkie odwołania do kotlin-stdlib-jdk7 lub kotlin-stdlib-jdk8. Obie zależności zostały połączone w kotlin-stdlibod Kotlin 1.8.0.