Система сборки Android Studio основана на Gradle, а плагин Android Gradle добавляет несколько функций, специфичных для сборки приложений Android. Хотя плагин Android Gradle (AGP) обычно обновляется вместе с Android Studio, он (и остальная часть системы Gradle) может работать независимо от Android Studio и обновляться отдельно.
На этой странице объясняется, как поддерживать инструменты Gradle в актуальном состоянии и что входит в последние обновления. Заметки о выпуске предыдущих версий плагина Gradle для Android см. в разделе «Заметки о выпуске» .
Чтобы узнать, что было исправлено в этой версии плагина 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.11.0 из файла build.gradle.kts :
Котлин
plugins { id("com.android.application") version "8.11.0" apply false id("com.android.library") version "8.11.0" apply false id("org.jetbrains.kotlin.android") version "2.1.20" apply false }
Круто
plugins { id 'com.android.application' version '8.11.0' apply false id 'com.android.library' version '8.11.0' apply false id 'org.jetbrains.kotlin.android' version '2.1.20' apply false }
Внимание: не следует использовать динамические зависимости в номерах версий, например, 'com.android.tools.build:gradle:8.11.+' . Использование этой функции может привести к неожиданным обновлениям версий и затруднить устранение различий между ними.
Если указанная версия плагина не была загружена, Gradle загрузит ее при следующей сборке проекта или при нажатии Файл > Синхронизировать проект с файлами Gradle в строке меню Android Studio.
Обновление Gradle
При обновлении Android Studio вам может быть предложено обновить Gradle до последней доступной версии. Вы можете принять обновление или вручную указать версию в соответствии с требованиями сборки вашего проекта.
В таблице ниже указано, какая версия Gradle требуется для каждой версии плагина Android Gradle. Для достижения наилучшей производительности следует использовать последнюю возможную версию как Gradle, так и плагина.
| Версия плагина | Минимальная требуемая версия Gradle |
|---|---|
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 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 |
Старые версии
| Версия плагина | Требуемая версия Gradle |
|---|---|
| 7.4 | 7.5 |
| 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.13 с помощью Gradle Wrapper. Обратите внимание, что для обновления Gradle и самого Gradle Wrapper эту команду необходимо выполнить дважды (подробнее см. в разделе «Обновление Gradle Wrapper» ).
gradle wrapper --gradle-version 8.13
Однако в некоторых случаях это может привести к сбою, например, если вы только что обновили AGP, и он больше не совместим с текущей версией Gradle. В этом случае необходимо отредактировать ссылку на дистрибутив Gradle в файле gradle/wrapper/gradle-wrapper.properties . В следующем примере в файле gradle-wrapper.properties устанавливается версия Gradle 8.13.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-bin.zip
...
Совместимость плагина Android Gradle и Android Studio
Система сборки Android Studio основана на Gradle, а плагин Android Gradle (AGP) добавляет несколько функций, специфичных для сборки приложений Android. В таблице ниже указано, какая версия AGP требуется для каждой версии Android Studio.
| Версия Android Studio | Требуемая версия AGP |
|---|---|
| Выпуск функций Narwhal | 2025.1.2 | 4.0-8.12 |
| Нарвал | 2025.1.1 | 3.2-8.11 |
| Выпуск функции Meerkat | 2024.3.2 | 3.2-8.10 |
| Сурикат | 2024.3.1 | 3.2-8.9 |
| Выпуск функции «Божья коровка» | 2024.2.2 | 3.2-8.8 |
| Божья коровка | 2024.2.1 | 3.2-8.7 |
| Выпуск функции Koala | 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 .
Минимальные версии инструментов для уровня API Android
Существуют минимальные версии Android Studio и AGP, поддерживающие определённый уровень API. Использование более ранних версий Android Studio или AGP, чем требуется для targetSdk или compileSdk вашего проекта, может привести к непредвиденным проблемам. Мы рекомендуем использовать последнюю предварительную версию Android Studio и AGP для работы над проектами, ориентированными на предварительные версии ОС Android. Вы можете установить предварительные версии Android Studio вместе со стабильной версией .
Минимальные версии Android Studio и AGP следующие:
| уровень API | Минимальная версия Android Studio | Минимальная версия AGP |
|---|---|---|
| 36.0 | Сурикат | 2024.3.1 Патч 1 | 8.9.1 |
| 35 | Выпуск функции Koala | 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.11, — API уровня 36. Вот дополнительная информация о совместимости:
| Минимальная версия | Версия по умолчанию | Примечания | |
|---|---|---|---|
| Грейдл | 8.13 | 8.13 | Более подробную информацию см. в разделе Обновление Gradle . |
| Инструменты сборки SDK | 35.0.0 | 35.0.0 | Установите или настройте инструменты сборки SDK. |
| НДК | Н/Д | 27.0.12077973 | Установите или настройте другую версию NDK. |
| JDK | 17 | 17 | Более подробную информацию см. в разделе Установка версии JDK . |
Исправлены проблемы
Плагин Android Gradle 8.11.0
| Исправленные проблемы | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Плагин Android Gradle |
| |||||||||
| Дексер (D8) |
| |||||||||
| Линт |
| |||||||||
| Усадочный аппарат (R8) |
| |||||||||
Плагин Android Gradle 8.11.1
| Исправленные проблемы |
|---|