Плагин Android Gradle 8.3.0 — это основная версия, включающая множество новых функций и улучшений.
Совместимость
Максимальный уровень API, который поддерживает плагин Android Gradle 8.3, — это уровень API 34. Вот другая информация о совместимости:
| Минимальная версия | Версия по умолчанию | Примечания | |
|---|---|---|---|
| Градл | 8.4 | 8.4 | Чтобы узнать больше, см. обновление Gradle . |
| Инструменты сборки SDK | 34.0.0 | 34.0.0 | Установите или настройте инструменты сборки SDK. |
| НДК | Н/Д | 25.1.8937393 | Установите или настройте другую версию NDK. |
| ЯДК | 17 | 17 | Дополнительные сведения см. в разделе Настройка версии JDK . |
Ниже приведены новые функции плагина Android Gradle 8.3.
Выпуски патчей
Ниже приведен список выпусков исправлений для Android Studio Iguana и плагина Android Gradle 8.3.
Android-студия Игуана | 2023.2.1, исправление 2 и AGP 8.3.2 (апрель 2024 г.)
Это незначительное обновление включает в себя исправления ошибок .
Android-студия Игуана | Обновление 1 2023.2.1 и AGP 8.3.1 (март 2024 г.)
Это незначительное обновление включает в себя исправления ошибок .
Поддержка каталогов версий Gradle
Android Studio поддерживает каталоги версий Gradle на основе TOML — функцию, которая позволяет управлять зависимостями в одном центральном месте и совместно использовать зависимости между модулями и проектами. Android Studio теперь упрощает настройку каталогов версий благодаря предложениям редактора и интеграции с диалоговым окном «Структура проекта» . Узнайте, как установить и настроить каталоги версий Gradle или как перенести сборку в каталоги версий .
Завершение кода и навигация
Android Studio предлагает автодополнение кода, когда вы редактируете каталог версий в формате файла TOML или добавляете зависимость из каталога версий в файл сборки. Чтобы использовать дополнение кода, нажмите Ctrl+Пробел ( Command+Пробел в macOS). Кроме того, вы можете быстро перейти от ссылки на зависимости в файле build.gradle вашего приложения к тому месту, где она объявлена в каталоге версий, нажав Ctrl+b ( Command+b в macOS).
Интеграция с диалогом структуры проекта
Если ваш проект использует каталог версий, определенный в формате файла TOML, вы можете редактировать переменные, которые вы там определили, с помощью диалогового окна « Структура проекта» «Просмотр переменных» ( «Файл» > «Структура проекта» > «Переменные ») в Android Studio. Для каждого каталога версий имеется раскрывающийся список, в котором перечислены переменные из этого каталога. Чтобы отредактировать переменную, щелкните ее значение и перезапишите его. Когда вы сохраняете эти изменения, файл TOML соответствующим образом обновляется.
Вы также можете обновить зависимости в диалоговом окне « Структура проекта» в представлении «Зависимости» ( «Файл» > «Структура проекта» > «Зависимости» ). Чтобы обновить версии с помощью диалогового окна «Структура проекта» , перейдите к модулю и зависимости, которые вы хотите изменить, а затем обновите поле «Запрошенная версия» . Когда вы сохраняете эти изменения, файл TOML соответствующим образом обновляется. Обратите внимание: если версия зависимости была определена с использованием переменной, обновление версии напрямую таким образом заменяет переменную жестко закодированным значением. Также имейте в виду, что удаление зависимости из файла сборки, независимо от того, используете ли вы диалоговое окно «Структура проекта» или нет, не удаляет зависимость из каталога версий.
Известные проблемы и ограничения
Ниже приведены известные проблемы или ограничения поддержки каталогов версий Gradle в Android Studio.
Ошибка выделения объявлений псевдонимов плагинов в файлах сценариев Kotlin: когда вы добавляете объявление плагина в форме
alias(libs.plugins.example), редактор добавляет красную подчеркивание под частьюlibs. Это известная проблема в Gradle версий 8.0 и ниже, и она будет решена в будущем выпуске Gradle.Поддержка Android Studio только для каталогов версий в формате TOML: в настоящее время поддержка диалоговых окон завершения кода, навигации и структуры проекта Android Studio доступна только для каталогов версий, определенных в формате файла TOML. Однако вы все равно можете добавить каталог версий непосредственно в файл
settings.gradleи использовать его зависимости в своем проекте.Навигация по файлам сборки KTS не поддерживается: переход к определению зависимостей в каталоге версий с помощью клавиши Control + щелчок ( Command + щелчок в macOS) пока не поддерживается для файлов сборки, написанных с использованием сценария Kotlin.
Firebase Assistant добавляет зависимости непосредственно в сценарии сборки: Firebase Assistant добавляет зависимости непосредственно в ваши сценарии сборки, а не через каталоги версий.
Функция «Найти использование» не поддерживается: поиск использования переменной каталога версий в других файлах сборки пока не поддерживается, независимо от того, находится ли файл сборки в KTS или Groovy. То есть использование Control +click ( Command +click в macOS) для определения переменной в каталоге версий не приводит к файлам сборки, в которых используется эта переменная.
Диалоговое окно «Структура проекта» в Android Studio отображает несколько файлов каталога, если они находятся в корневой папке
gradle, но не отображает каталоги для составной сборки . Например, если у вас есть два файла каталога — один для вашего приложения и один для составной сборки — в диалоговом окне «Структура проекта» отображается только файл каталога приложения. Вы можете использовать составную сборку, но вам придется редактировать ее файл TOML напрямую.
Дополнительные сведения о SDK: проблемы политики
Android Studio отображает предупреждения lint в файлах build.gradle.kts и build.gradle а также в диалоговом окне структуры проекта для общедоступных SDK, которые имеют нарушения политики Play в индексе Google Play SDK . Вам следует обновить все зависимости, которые нарушают политику Play, поскольку эти нарушения могут помешать вам публиковать файлы в консоли Google Play в будущем. Предупреждения о нарушении политики дополняют предупреждения об устаревших версиях, отображаемые Android Studio.
Поддержка версии Android Studio compileSdk
Android Studio отображает предупреждение, если ваш проект использует compileSdk , который не поддерживается текущей версией Android Studio. Если доступно, также предлагается перейти на версию Android Studio, поддерживающую compileSdk , используемый вашим проектом. Имейте в виду, что обновление Android Studio может также потребовать обновления AGP . AGP также отображает предупреждение в окне инструмента сборки , если compileSdk , используемый вашим проектом, не поддерживается текущей версией AGP.
Изменения в поведении ворса
Начиная с плагина Android Gradle 8.3.0-alpha02, при запуске lint на модуле выполняются отдельные задачи lint-анализа для основного и тестового компонентов модуля. Причина этого изменения — улучшение производительности. Чтобы вернуться к предыдущему поведению, установите android.experimental.lint.analysisPerComponent=false в файле gradle.properties .
Точное сокращение ресурса включено по умолчанию
Точное сжатие ресурсов, при котором удаляются неиспользуемые записи из файла resources.arsc и неиспользуемые файлы ресурсов, включено по умолчанию. Когда это сжатие включено, ваша таблица ресурсов уменьшается, и в APK включаются только записи папок, на res имеются ссылки.
Чтобы отключить точное сжатие ресурсов, установите android.enableNewResourceShrinker.preciseShrinking значение false в файле gradle.properties вашего проекта.
Исправлены проблемы
Плагин Android Gradle 8.3.0
| Исправленные проблемы | ||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Плагин Android Gradle |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Дексер (D8) |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Ворс |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Интеграция Линта |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Шринкер (R8) |
| |||||||||||||||||||||||||||||||||||||||||||||||||
Плагин Android Gradle 8.3.1
| Исправленные проблемы | ||
|---|---|---|
| Плагин Android Gradle |
| |
| Интеграция Линта |
| |
Плагин Android Gradle 8.3.2
| Исправленные проблемы | |||
|---|---|---|---|
| Плагин Android Gradle |
| ||
| Интеграция Линта |
| ||
Плагин Android Gradle 8.3.0 — это основная версия, включающая множество новых функций и улучшений.
Совместимость
Максимальный уровень API, который поддерживает плагин Android Gradle 8.3, — это уровень API 34. Вот другая информация о совместимости:
| Минимальная версия | Версия по умолчанию | Примечания | |
|---|---|---|---|
| Градл | 8.4 | 8.4 | Чтобы узнать больше, см. обновление Gradle . |
| Инструменты сборки SDK | 34.0.0 | 34.0.0 | Установите или настройте инструменты сборки SDK. |
| НДК | Н/Д | 25.1.8937393 | Установите или настройте другую версию NDK. |
| ЯДК | 17 | 17 | Дополнительные сведения см. в разделе Настройка версии JDK . |
Ниже приведены новые функции плагина Android Gradle 8.3.
Выпуски патчей
Ниже приведен список выпусков исправлений для Android Studio Iguana и плагина Android Gradle 8.3.
Android-студия Игуана | 2023.2.1, исправление 2 и AGP 8.3.2 (апрель 2024 г.)
Это незначительное обновление включает в себя исправления ошибок .
Android-студия Игуана | Обновление 1 2023.2.1 и AGP 8.3.1 (март 2024 г.)
Это незначительное обновление включает в себя исправления ошибок .
Поддержка каталогов версий Gradle
Android Studio поддерживает каталоги версий Gradle на основе TOML — функцию, которая позволяет управлять зависимостями в одном центральном месте и совместно использовать зависимости между модулями и проектами. Android Studio теперь упрощает настройку каталогов версий благодаря предложениям редактора и интеграции с диалоговым окном «Структура проекта» . Узнайте, как установить и настроить каталоги версий Gradle или как перенести сборку в каталоги версий .
Завершение кода и навигация
Android Studio предлагает автодополнение кода, когда вы редактируете каталог версий в формате файла TOML или добавляете зависимость из каталога версий в файл сборки. Чтобы использовать дополнение кода, нажмите Ctrl+Пробел ( Command+Пробел в macOS). Кроме того, вы можете быстро перейти от ссылки на зависимости в файле build.gradle вашего приложения к тому месту, где она объявлена в каталоге версий, нажав Ctrl+b ( Command+b в macOS).
Интеграция с диалогом структуры проекта
Если ваш проект использует каталог версий, определенный в формате файла TOML, вы можете редактировать переменные, которые вы там определили, с помощью диалогового окна « Структура проекта» «Просмотр переменных» ( «Файл» > «Структура проекта» > «Переменные ») в Android Studio. Для каждого каталога версий имеется раскрывающийся список, в котором перечислены переменные из этого каталога. Чтобы отредактировать переменную, щелкните ее значение и перезапишите его. Когда вы сохраняете эти изменения, файл TOML соответствующим образом обновляется.
Вы также можете обновить зависимости в диалоговом окне « Структура проекта» в представлении «Зависимости» ( «Файл» > «Структура проекта» > «Зависимости» ). Чтобы обновить версии с помощью диалогового окна «Структура проекта» , перейдите к модулю и зависимости, которые вы хотите изменить, а затем обновите поле «Запрошенная версия» . Когда вы сохраняете эти изменения, файл TOML соответствующим образом обновляется. Обратите внимание: если версия зависимости была определена с использованием переменной, обновление версии напрямую таким образом заменяет переменную жестко закодированным значением. Также имейте в виду, что удаление зависимости из файла сборки, независимо от того, используете ли вы диалоговое окно «Структура проекта» или нет, не удаляет зависимость из каталога версий.
Известные проблемы и ограничения
Ниже приведены известные проблемы или ограничения поддержки каталогов версий Gradle в Android Studio.
Ошибка выделения объявлений псевдонимов плагинов в файлах сценариев Kotlin: когда вы добавляете объявление плагина в форме
alias(libs.plugins.example), редактор добавляет красную подчеркивание под частьюlibs. Это известная проблема в Gradle версий 8.0 и ниже, и она будет решена в будущем выпуске Gradle.Поддержка Android Studio только для каталогов версий в формате TOML: в настоящее время поддержка диалоговых окон завершения кода, навигации и структуры проекта Android Studio доступна только для каталогов версий, определенных в формате файла TOML. Однако вы все равно можете добавить каталог версий непосредственно в файл
settings.gradleи использовать его зависимости в своем проекте.Навигация по файлам сборки KTS не поддерживается: переход к определению зависимостей в каталоге версий с помощью клавиши Control + щелчок ( Command + щелчок в macOS) пока не поддерживается для файлов сборки, написанных с использованием сценария Kotlin.
Firebase Assistant добавляет зависимости непосредственно в сценарии сборки: Firebase Assistant добавляет зависимости непосредственно в ваши сценарии сборки, а не через каталоги версий.
Функция «Найти использование» не поддерживается: поиск использования переменной каталога версий в других файлах сборки пока не поддерживается, независимо от того, находится ли файл сборки в KTS или Groovy. То есть использование Control +click ( Command +click в macOS) для определения переменной в каталоге версий не приводит к файлам сборки, в которых используется эта переменная.
Диалоговое окно «Структура проекта» в Android Studio отображает несколько файлов каталога, если они находятся в корневой папке
gradle, но не отображает каталоги для составной сборки . Например, если у вас есть два файла каталога — один для вашего приложения и один для составной сборки — в диалоговом окне «Структура проекта» отображается только файл каталога приложения. Вы можете использовать составную сборку, но вам придется редактировать ее файл TOML напрямую.
Дополнительные сведения о SDK: проблемы политики
Android Studio отображает предупреждения о проверке в файлах build.gradle.kts и build.gradle а также в диалоговом окне структуры проекта для общедоступных SDK, которые имеют нарушения политики Play в индексе Google Play SDK . Вам следует обновить все зависимости, которые нарушают политику Play, поскольку эти нарушения могут помешать вам публиковать файлы в консоли Google Play в будущем. Предупреждения о нарушении политики дополняют предупреждения об устаревших версиях, отображаемые Android Studio.
Поддержка версии Android Studio compileSdk
Android Studio отображает предупреждение, если ваш проект использует compileSdk , который не поддерживается текущей версией Android Studio. Если доступно, также предлагается перейти на версию Android Studio, поддерживающую compileSdk , используемый вашим проектом. Имейте в виду, что обновление Android Studio может также потребовать обновления AGP . AGP также отображает предупреждение в окне инструмента сборки , если compileSdk , используемый вашим проектом, не поддерживается текущей версией AGP.
Изменения в поведении ворса
Начиная с плагина Android Gradle 8.3.0-alpha02, при запуске lint на модуле выполняются отдельные задачи lint-анализа для основного и тестового компонентов модуля. Причина этого изменения — улучшение производительности. Чтобы вернуться к предыдущему поведению, установите android.experimental.lint.analysisPerComponent=false в файле gradle.properties .
Точное сокращение ресурса включено по умолчанию
Точное сжатие ресурсов, при котором удаляются неиспользуемые записи из файла resources.arsc и неиспользуемые файлы ресурсов, включено по умолчанию. Когда это сжатие включено, ваша таблица ресурсов уменьшается, и в APK включаются только записи папок, на res имеются ссылки.
Чтобы отключить точное сжатие ресурсов, установите android.enableNewResourceShrinker.preciseShrinking значение false в файле gradle.properties вашего проекта.
Исправлены проблемы
Плагин Android Gradle 8.3.0
| Исправленные проблемы | ||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Плагин Android Gradle |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Дексер (D8) |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Ворс |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Интеграция Линта |
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Шринкер (R8) |
| |||||||||||||||||||||||||||||||||||||||||||||||||
Плагин Android Gradle 8.3.1
| Исправленные проблемы | ||
|---|---|---|
| Плагин Android Gradle |
| |
| Интеграция Линта |
| |
Плагин Android Gradle 8.3.2
| Исправленные проблемы | |||
|---|---|---|---|
| Плагин Android Gradle |
| ||
| Интеграция Линта |
| ||