О плагине 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 скачает ее при следующей сборке проекта или когда вы выберете File (Файл) > Sync Project with Gradle Files (Синхронизировать проект с файлами Gradle) в строке меню Android Studio.

Обновить Gradle

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

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

Вы можете указать версию Gradle в меню File (Файл) > Project Structure (Структура проекта) > Project (Проект) в Android Studio или обновить версию Gradle с помощью командной строки. Рекомендуемый способ – использовать инструмент командной строки 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 можно найти в примечаниях к выпуску.

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

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

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