Обновления Gradle и плагина Android Gradle
Обновление версий Gradle и плагина Android Gradle
Во-первых, обновите версии Gradle и плагина Android Gradle. Это обновление включает в себя улучшенную совместимость с некоторыми зависимостями SDK (включая Kotlin 1.9), а также исправление некоторых критических ошибок.
Для этого основного выпуска SDK требуются следующие зависимости версий для вашего проекта приложения Android:
- версия Gradle не ниже v7.5.0, но не выше v7.6.0.
- версия Android Gradle Plugin (AGP) в диапазоне v7.4.x.
Вы можете использовать более новую версию плагинов; однако вы можете столкнуться с предупреждениями об устаревании, а некоторые новые функции могут не работать.
Чтобы изменить версию Gradle, измените строку в файле /gradle/wrapper/gradle-wrapper.properties
вашего проекта.
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip
Чтобы изменить версию плагина Android Gradle, отредактируйте файл build.gradle
, содержащий блок buildscript
. Например:
buildscript {
repositories {
google()
mavenCentral()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:7.4.1'
}
}
Поддержка миграции библиотек с Java 7 на Java 8
Шаг 1. Включите поддержку библиотеки Java 8.
Поскольку минимальный уровень API SDK — 23, а требуемая версия AGP — 7.4+, конфигурация немного отличается от указанной исходной документации.
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'
}
Шаг 2 — Переход с Proguard или Dexguard на R8
AGP v7.4+ использует R8 в качестве инструмента сжатия, обфускации и оптимизации двоичного файла по умолчанию, поэтому на этом этапе никаких специальных действий не требуется.
Если проект перенесен с AGP 4.0+, AGP может выдать следующие предупреждения об удалении файлов:
-
useProguard true
в файлеbuild.gradle
- использование
android.enableR8=false
в файлеgradle.properties
Удаление этих линий обычно решает эти проблемы.
Миграция с Kotlin 1.6 на 1.9
Шаг 1 — Переход на Kotlin Gradle Plugin 1.9.0
Обновите версию плагина Kotlin Gradle в файле build.gradle модуля верхнего уровня вашего приложения. Не забудьте добавить org.jetbrains.kotlin:kotlin-gradle-plugin
в зависимости блока buildscript, если он отсутствует.
buildscript {
dependencies {
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
}
}
Если вы используете Kotlin Gradle Plugin 1.6.X или 1.7.X, вам необходимо перенести приложение из Kotlin-synthetics. Подробнее см. в официальном руководстве по миграции .
Шаг 2 — Обновите kotlin-stdlib до версии 1.9.0
Обновите kotlin-stblib
до версии 1.9.0 в файле build.gradle вашего приложения.
dependencies {
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
}
Обязательно удалите все ссылки на kotlin-stdlib-jdk7
или kotlin-stdlib-jdk8
. Обе зависимости были объединены в kotlin-stdlib
начиная с версии Kotlin 1.8.0 .