Обновление версий
Своевременное обновление версий Gradle и его плагинов гарантирует, что вы используете наиболее актуальную версию без багов и уязвимостей.
Также с выходом новых обновлений появляются новые функции, которые, возможно, понадобятся в проекте.
Gradle
Мы используем Gradle Wrapper как обертку, которая автоматизирует процесс установки нужной версии Gradle.
Чтобы поменять версию Gradle в вашем проекте, необходимо перейти в директорию gradle/wrapper и открыть файл его настроек gradle-wrapper.properties:
# ...
# URL-адрес для загрузки дистрибутива Gradle
distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-bin.zip
# ...
Каталог с возможными версиями Gradle вы можете найти тут.
caution
Gradle придерживается такого подхода к версионированию, при котором апдейты минорных версий не нарушают обратную совместимость.
При обновлении же мажорных версий, например Gradle 6.9.1 ~> 7.0.2, есть высокая вероятность,
что что-то будет несовместимо, поэтому такие апдейты надо делать аккуратно и проверять, что будет с обеими платформами.
Plugins
Что делать, если Android Studio предложила обновить Android Gradle Plugin (AGP) или Kotlin Gradle Plugin? Какие плагины и зависимости можно обновлять без последствий?
Kotlin и Android
В принципе, вы можете обновлять все плагины и зависимости, поддерживающие семантическое версионирование, но на минорных апдейтах, чтобы не нарушалась обратная совместимость.
Android Gradle Plugin поддерживает семантическое версионирование,
поэтому при обновлении AGP в рамках минорной версии (например, 8.7 → 8.9) ничего сломаться не должно.
Kotlin придерживается собственной схемы версионирования, подробнее — тут.
Например, если в вашем проекте используется Kotlin Multiplatform Plugin:
plugins {
kotlin("multiplatform") version "2.1.10"
}
При смене major версии (2.0 → 3.0) возможны breaking changes — проверяйте компиляцию обеих платформ и работу кода.
Смена feature версии (2.0 → 2.1) обратно совместима, но могут потребоваться обновления библиотек.
Bugfix обновления (2.1.10 → 2.1.20) полностью безопасны.