Система сборки Android Studio основана на Gradle, а плагин Android Gradle добавляет несколько функций, специфичных для создания приложений Android. Хотя плагин Android Gradle (AGP) обычно обновляется одновременно с Android Studio, плагин (и остальная часть системы Gradle) могут работать независимо от Android Studio и обновляться отдельно.
На этой странице объясняется, как поддерживать актуальность инструментов 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. В следующем примере для плагина устанавливается версия 8.7.0 из файла build.gradle.kts :
Котлин
plugins { id("com.android.application") version "8.7.0" apply false id("com.android.library") version "8.7.0" apply false id("org.jetbrains.kotlin.android") version "2.0.20" apply false }
классный
plugins { id 'com.android.application' version '8.7.0' apply false id 'com.android.library' version '8.7.0' apply false id 'org.jetbrains.kotlin.android' version '2.0.20' apply false }
Внимание: не следует использовать динамические зависимости в номерах версий, например 'com.android.tools.build:gradle:8.7.+' . Использование этой функции может привести к неожиданным обновлениям версий и трудностям с устранением различий версий.
Если указанная версия плагина не была загружена, Gradle загрузит ее при следующей сборке проекта или при нажатии «Файл» > «Синхронизировать проект с файлами Gradle» в строке меню Android Studio.
Обновить Gradle
При обновлении Android Studio вы можете получить предложение также обновить Gradle до последней доступной версии. Вы можете принять обновление или вручную указать версию в зависимости от требований сборки вашего проекта.
В следующей таблице указано, какая версия Gradle требуется для каждой версии плагина Android Gradle. Для достижения наилучшей производительности вам следует использовать последнюю возможную версию Gradle и плагина.
| Версия плагина | Минимальная необходимая версия Gradle |
|---|---|
| 8,7 | 8,9 |
| 8,6 | 8,7 |
| 8,5 | 8,7 |
| 8.4 | 8,6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7,5 |
Старые версии
| Версия плагина | Требуемая версия Gradle |
|---|---|
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0+ | 6.7.1 |
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1+ |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3,5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2,9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
Вы можете указать версию Gradle в меню «Файл» > «Структура проекта» > «Проект» в Android Studio или обновить версию Gradle с помощью командной строки. Предпочтительный способ — использовать инструмент командной строки Gradle Wrapper , который обновляет сценарии gradlew . В следующем примере для версии Gradle устанавливается значение 8.7 с помощью Gradle Wrapper. Обратите внимание: вам нужно запустить эту команду дважды , чтобы обновить как Gradle, так и саму оболочку Gradle (дополнительную информацию см. в разделе Обновление оболочки Gradle ).
gradle wrapper --gradle-version 8.7
Однако в некоторых случаях это может привести к сбою, например, если вы только что обновили AGP, и он больше не совместим с текущей версией Gradle. В этом случае вам необходимо отредактировать ссылку на дистрибутив Gradle в файле gradle/wrapper/gradle-wrapper.properties . В следующем примере в файле gradle-wrapper.properties устанавливается версия Gradle 8.7.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.7-bin.zip
...
Плагин Android Gradle и совместимость с Android Studio
Система сборки Android Studio основана на Gradle, а плагин Android Gradle (AGP) добавляет несколько функций, специфичных для создания приложений Android. В следующей таблице указано, какая версия AGP требуется для каждой версии Android Studio.
| Версия Android Studio | Требуемая версия AGP |
|---|---|
| Божья коровка | 2024.2.1 | 3,2-8,7 |
| Функция «Коала» | 2024.1.2 | 3,2-8,6 |
| Коала | 2024.1.1 | 3,2-8,5 |
| Медуза | 2023.3.1 | 3,2-8,4 |
| Игуана | 2023.2.1 | 3,2-8,3 |
| Ежик | 2023.1.1 | 3,2-8,2 |
| Жираф | 2022.3.1 | 3.2-8.1 |
| Фламинго | 2022.2.1 | 3,2-8,0 |
Старые версии
| Версия Android Studio | Требуемая версия AGP |
|---|---|
| Электрический угорь | 2022.1.1 | 3,2-7,4 |
| Дельфин | 2021.3.1 | 3,2-7,3 |
| Бурундук | 2021.2.1 | 3,2-7,2 |
| Шмель | 2021.1.1 | 3.2-7.1 |
| Арктическая лисица | 2020.3.1 | 3,1-7,0 |
Информацию о новых возможностях плагина Android Gradle см. в примечаниях к выпуску плагина Android Gradle .
Минимальные версии инструментов для уровня Android API
Существуют минимальные версии Android Studio и AGP, поддерживающие определенный уровень API. Использование более ранних версий Android Studio или AGP, чем требуется targetSdk или compileSdk вашего проекта, может привести к непредвиденным проблемам. Мы рекомендуем использовать последнюю предварительную версию Android Studio и AGP для работы над проектами, ориентированными на предварительные версии ОС Android. Вы можете установить предварительные версии Android Studio вместе со стабильной версией .
Минимальные версии Android Studio и AGP следующие:
| уровень API | Минимальная версия Android Studio | Минимальная версия AGP |
|---|---|---|
| 35 | Функция «Коала» | 2024.2.1 | 8.6.0 |
| 34 | Ежик | 2023.1.1 | 8.1.1 |
| 33 | Фламинго | 2022.2.1 | 7.2 |
Изменения версий (ноябрь 2020 г.)
Мы обновляем нумерацию версий плагина Android Gradle (AGP), чтобы она больше соответствовала базовому инструменту сборки Gradle.
Вот заметные изменения:
AGP теперь будет использовать семантическое управление версиями, а критические изменения будут нацелены на основные выпуски.
Ежегодно будет выпускаться одна основная версия AGP, согласованная с основной версией Gradle.
Выпуск после AGP 4.2 будет версией 7.0 и потребует обновления до Gradle версии 7.x. Каждый основной выпуск AGP потребует обновления основной версии базового инструмента Gradle.
API-интерфейсы будут прекращены примерно за год до этого, и одновременно с ними станут доступны новые функциональные возможности. Устаревшие API будут удалены примерно через год во время последующего крупного обновления.
Совместимость
Максимальный уровень API, который поддерживает плагин Android Gradle 8.6, — это уровень API 34. Вот другая информация о совместимости:
| Минимальная версия | Версия по умолчанию | Примечания | |
|---|---|---|---|
| "Грейдл" | 8,9 | 8,9 | «Чтобы узнать больше, см. обновление Gradle ». |
| Инструменты сборки SDK | 34.0.0 | 34.0.0 | Установите или настройте инструменты сборки SDK. |
| НДК | Н/Д | 27.0.12077973 | « Установите или настройте другую версию NDK». |
| ЯДК | 17 | 17 | «Чтобы узнать больше, см. настройку версии JDK ». |
Изменение поведения ворса
Начиная с плагина Android Gradle 8.7.0-alpha08, если при запуске lint с использованием Gradle возникает LintError , задача анализа lint выдает исключение. Это изменение предотвращает кэширование редких ошибок в кэше сборки.
К сожалению, это изменение нарушает сборку проектов с подлинными экземплярами LintError в базовых файлах lint. Сообщение об ошибке содержит информацию о том, какие проверки на наличие ворса вызывают проблему. В некоторых случаях обновление соответствующей зависимости библиотеки может решить проблему. Если нет, вы можете отключить проверку проблемных ворсинок, пока автор библиотеки не исправит ее.
Исправлены проблемы
Плагин Android Gradle 8.7.0
| Исправленные проблемы | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Плагин Android Gradle |
| |||||||||
| Ворс |
| |||||||||