О плагине 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 до последней доступной версии. Вы можете принять обновление или указать версию вручную в соответствии с требованиями сборки вашего проекта.

Версию плагина можно указать либо в меню «Файл > Структура проекта > Проект» в 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, так и плагина.

You can specify the Gradle version in either the File > Project Structure > Project menu in Android Studio, or update your Gradle version using the command line. The preferred way is to use the Gradle Wrapper command line tool, which updates the gradlew scripts. The following example sets the Gradle version to 9.6.0 using the Gradle Wrapper. Note, you need to run this command twice to upgrade both Gradle and the Gradle Wrapper itself (for more information, see Upgrading the Gradle Wrapper ).

gradle wrapper --gradle-version 9.6.0

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

...
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 Gradle .

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

There are minimum versions of Android Studio and AGP that support a specific API level. Using lower versions of Android Studio or AGP than required by your project's targetSdk or compileSdk could lead to unexpected issues. We recommend using the latest preview version of Android Studio and AGP to work on projects that target preview versions of the Android OS. You can install preview versions of Android Studio alongside a stable version .

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