Как безопасно обновить Gradle/AGP и быстро исправить ошибки сборки

Как безопасно обновить Gradle/AGP и быстро исправить ошибки сборки

Коротко: менять версии надо по шагам — backup → Gradle Wrapper → AGP → Kotlin/плагины → библиотеки; между шагами запускать сборку и фиксить ошибки. Ниже — практические действия и типичные исправления.

- Перед стартом: зафиксировать изменения в VCS (commit + tag/branch). Это позволит откатиться при проблемах.

- Обновление wrapper: выполнить ./gradlew wrapper --gradle-version X.YZ --distribution-type all, затем ./gradlew --version и ./gradlew clean. Закоммитить скрипты wrapper.

- Обновление AGP: поменять classpath "com.android.tools.build:gradle:V" в корневом build.gradle или в version catalog; синхронизировать проект.

- Kotlin/плагины и библиотеки: проверить совместимость Kotlin/annotation processors; перейти на Version Catalog (libs.versions.toml) и запустить com.github.ben-manes.versions для аудита зависимостей.

- Быстрые фиксы типичных ошибок:

- "Minimum supported Gradle version" — обновить wrapper и запускать ./gradlew (не системный gradle).

- "Could not find ..." — проверить google() и mavenCentral() в repos и отключить оффлайн/прокси.

- Нужен namespace и явный compileSdk в модуле.

- Duplicate class — найти через ./gradlew :app:dependencies и исключить транситивы или выровнять версии.

- KAPT — включить kapt { correctErrorTypes = true } или перейти на KSP, если доступно.

- CI падает, локально OK — сверить JDK, использовать wrapper и очистить CI-кэши.

Вывод: соблюдать порядок (wrapper → AGP → Kotlin → библиотеки), тестировать локально и в CI, фиксировать окружение в README/CI.

Подробнее: https://www.ivan-kornev.ru/articles/android/setup/gradle-android-studio-obnovit-plugins-zavisimosti-oshibki