О плагине Android Gradle

Система сборки Android Studio основана на Gradle, а плагин Android Gradle добавляет несколько функций, предназначенных для сборки приложений Android.

На этой странице рассказывается, как поддерживать инструменты Gradle в актуальном состоянии. Примечания к выпуску плагина Android Gradle можно найти на этой странице.

Общие сведения о предстоящих критических изменениях в плагине Android Gradle можно найти в дорожной карте плагина Android Gradle.

Подробнее о том, как настроить сборки Android с помощью Gradle:

• Настройте сборку
• Справочник по DSL плагина Android Gradle
• Справочник по Gradle DSL
• Руководство пользователя по производительности Gradle

Дополнительную информацию о системе сборки Gradle можно найти в руководстве пользователя Gradle.

android skills add agp-9-upgrade

Как обновить плагин Android Gradle

При обновлении Android Studio может появиться запрос на автоматическое обновление плагина Android Gradle до последней доступной версии. Вы можете принять обновление или вручную указать версию в соответствии с требованиями к сборке проекта.

Указать версию плагина можно в меню File (Файл) > Project Structure (Структура проекта) > Project (Проект) в Android Studio или в файле build.gradle.kts верхнего уровня. Версия плагина применяется ко всем модулям, созданным в этом проекте Android Studio. В следующем примере показано, как задать версию плагина 9.4.0 из файла build.gradle.kts:

plugins {
    id("com.android.application") version "9.4.0" apply false
    id("com.android.library") version "9.4.0" apply false
    id("org.jetbrains.kotlin.android") version "2.4.10" apply false
}

plugins {
    id 'com.android.application' version '9.4.0' apply false
    id 'com.android.library' version '9.4.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.4.10' apply false
}

Внимание! Не используйте динамические зависимости в номерах версий, например 'com.android.tools.build:gradle:9.4.+'. Использование этой функции может привести к неожиданным обновлениям версий и трудностям при устранении различий между версиями.

Если указанная версия плагина не скачана, Gradle скачает ее при следующей сборке проекта или при выборе Файл > Синхронизировать проект с файлами Gradle в строке меню Android Studio.

Как обновить Gradle

При обновлении Android Studio может появиться запрос на обновление Gradle до последней доступной версии. Вы можете принять обновление или вручную указать версию в соответствии с требованиями к сборке проекта.

В таблице ниже указано, какая версия Gradle требуется для каждой версии плагина Android Gradle. Для оптимальной работы рекомендуется использовать последние версии Gradle и плагина.

Указать версию Gradle можно в меню File > Project Structure (Структура проекта) > Project (Проект) в Android Studio или с помощью командной строки. Рекомендуется использовать инструмент командной строки Gradle Wrapper, который обновляет скрипты gradlew. В следующем примере с помощью Gradle Wrapper задается версия Gradle 9.6.0. Обратите внимание, что эту команду нужно выполнить дважды, чтобы обновить и Gradle, и Gradle Wrapper (подробнее об обновлении Gradle Wrapper…).

gradle wrapper --gradle-version 9.6.0

Однако в некоторых случаях это может не сработать, например если вы только что обновили AGP и он больше не совместим с текущей версией Gradle. В этом случае вам нужно изменить ссылку на дистрибутив Gradle в файле gradle/wrapper/gradle-wrapper.properties. В приведенном ниже примере в файле gradle-wrapper.properties задана версия Gradle 9.6.0.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip
...

Совместимость плагина Android Gradle и Android Studio

Система сборки Android Studio основана на Gradle, а плагин Android Gradle (AGP) добавляет несколько функций, предназначенных для сборки приложений Android. В таблице ниже указано, какая версия AGP требуется для каждой версии Android Studio.

Чтобы узнать, что нового в плагине Android Gradle, ознакомьтесь с примечаниями к его выпуску.

Минимальные версии инструментов для уровня API Android

Для каждого уровня API есть минимальные поддерживаемые версии Android Studio и AGP. Использование более ранних версий Android Studio или AGP, чем требуется для targetSdk или compileSdk проекта, может привести к неожиданным проблемам. Для работы с проектами, предназначенными для предварительных версий ОС Android, рекомендуем использовать последнюю предварительную версию Android Studio и AGP. Вы можете установить предварительные версии Android Studio вместе со стабильной версией.

Минимальные версии Android Studio и AGP: