Migracja dla pakietu Android Consumer SDK w wersji 2.0.0

Aktualizacje Gradle i wtyczki Androida do obsługi Gradle

Aktualizacja wersji Gradle i wtyczki Androida do obsługi Gradle

Najpierw zaktualizuj wersje Gradle i wtyczki Androida do obsługi Gradle. Ta aktualizacja obejmuje lepszą zgodność z niektórymi zależnościami pakietu SDK (w tym Kotlin 1.9), a także poprawki błędów krytycznych.

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

  • Gradle w wersji co najmniej 7.5.0, ale nie wyższej niż 7.6.0.
  • wtyczka Androida do obsługi Gradle w wersji 7.4.x lub nowszej,

Możesz kierować reklamy na użytkowników korzystających z wyższej wersji wtyczek, ale może to spowodować wyświetlanie ostrzeżeń o wycofaniu lub nieprawidłowe działanie niektórych nowych funkcji.

Aby zmienić wersję Gradle, zmodyfikuj 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, zmodyfikuj 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 biblioteki Java 7 na bibliotekę 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 różni się nieco od wspomnianej 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. Przejście z Proguard lub Dexguard na R8

R8, źródło

AGP w wersji 7.4 i nowszej używa R8 jako domyślnego narzędzia do kompresji, zaciemnienia i optymalizacji pliku binarnego, więc na razie nie musisz podejmować żadnych specjalnych działań.

Jeśli projekt został przeniesiony z wersji AGP 4.0 lub nowszej, AGP może wyświetlać te ostrzeżenia dotyczące usuwania plików:

  • Użycie danych useProguard true w pliku build.gradle
  • Użycie danych android.enableR8=false w pliku gradle.properties

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

Migracja z Kotlin 1.6 na 1.9

Krok 1. Przejdź na wtyczkę Kotlin Gradle 1.9.0

Źródło

Zaktualizuj wersję wtyczki Kotlin Gradle w pliku build.gradle w module na najwyższym poziomie aplikacji. Jeśli brakuje go w bloku buildscript, pamiętaj, aby dodać go do zależności.org.jetbrains.kotlin:kotlin-gradle-plugin

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

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

Krok 2. Zaktualizuj kotlin-stdlib do wersji 1.9.0

Źródło

W pliku build.gradle aplikacji zmień wartość kotlin-stblib na 1.9.0.

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

Pamiętaj, aby usunąć wszelkie odniesienia do kotlin-stdlib-jdk7 lub kotlin-stdlib-jdk8. Oba te zależności zostały scalone w kotlin-stdlib w wersji Kotlin 1.8.0.