Заметки о выпуске плагина Android Gradle 8.13

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

На этой странице объясняется, как поддерживать инструменты Gradle в актуальном состоянии и что входит в последние обновления. Заметки о выпуске предыдущих версий плагина Gradle для Android см. в разделе «Заметки о выпуске» .

Краткий обзор предстоящих критических изменений в плагине 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.13.0 из файла build.gradle.kts :

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

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

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

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

Обновление Gradle

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

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

Вы можете указать версию 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 Gradle см. в заметках о выпуске плагина Android Gradle .

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

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

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

Изменения в управлении версиями (ноябрь 2020 г.)

Мы обновляем нумерацию версий плагина Android Gradle (AGP) для большего соответствия базовому инструменту сборки Gradle.

Вот заметные изменения:

• Теперь AGP будет использовать семантическое управление версиями, а критические изменения будут вноситься в основные выпуски.

• Ежегодно будет выпускаться одна основная версия AGP, соответствующая основному релизу Gradle.

• После AGP 4.2 выйдет версия 7.0, требующая обновления до версии Gradle 7.x. Каждый крупный релиз AGP потребует обновления основной версии инструмента Gradle.

• API будут прекращены примерно за год до обновления, а заменяющие их функции станут доступны одновременно. Устаревшие API будут удалены примерно через год во время следующего крупного обновления.

Совместимость

Максимальный уровень API, поддерживаемый плагином Android Gradle 8.13, — это уровень API 36. Вот дополнительная информация о совместимости:

Исправлены проблемы

Плагин Android Gradle 8.13.0