О плагине 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 Gradle.

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

Версию плагина можно указать либо в меню «Файл > Структура проекта > Проект» в Android Studio, либо в файле build.gradle.kts верхнего уровня. Версия плагина применяется ко всем модулям, собранным в этом проекте Android Studio. В следующем примере версия плагина устанавливается на 9.0 из файла build.gradle.kts :

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

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

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

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

Обновить Gradle

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

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

Вы можете указать версию Gradle либо в меню File > Project Structure > Project в Android Studio, либо обновить версию Gradle с помощью командной строки. Предпочтительный способ — использовать инструмент командной строки Gradle Wrapper , который обновляет скрипты gradlew . В следующем примере версия Gradle устанавливается на 9.1.0 с помощью Gradle Wrapper. Обратите внимание, что для обновления как Gradle, так и самого Gradle Wrapper необходимо выполнить эту команду дважды (подробнее см. раздел «Обновление Gradle Wrapper »).

gradle wrapper --gradle-version 9.1.0

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

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

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

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

Для получения информации о нововведениях в плагине Android Gradle см. примечания к выпуску плагина Android Gradle .

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

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

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