Плагин Android Gradle 8.1.0 (июль 2023 г.)

Плагин Android Gradle 8.1.0 – это основной выпуск, в который входит множество новых функций и улучшений.

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

Kotlin DSL используется для конфигурации сборки по умолчанию

В новых проектах для конфигурации сборки по умолчанию используется Kotlin DSL (build.gradle.kts). Это удобнее, чем Groovy DSL (build.gradle), поскольку в Kotlin DSL есть подсветка синтаксиса, автозаполнение кода и переход к объявлениям. Если вы используете AGP 8.1 и Kotlin DSL для конфигурации сборки, рекомендуем использовать Gradle 8.1. Подробнее о руководстве по переносу на Kotlin DSL…

Автоматическая поддержка языковых настроек для отдельных приложений

Начиная с Android Studio Giraffe Canary 7 и AGP 8.1.0-alpha07 вы можете настроить приложение так, чтобы оно автоматически поддерживало настройки языка для каждого приложения. На основе ресурсов проекта плагин Android Gradle создает файл LocaleConfig и добавляет ссылку на него в итоговый файл манифеста. Вам больше не нужно делать это вручную. AGP использует ресурсы из папок res модулей приложения и любые зависимости модулей библиотеки, чтобы определить, какие языковые стандарты нужно включить в файл LocaleConfig.

Обратите внимание, что функция автоматического выбора языка для каждого приложения поддерживается в приложениях, которые работают на Android 13 (уровень API 33) или более поздней версии. Чтобы использовать эту функцию, установите значение параметра "Уровень конфиденциальности"compileSdkVersion на 33 или выше. Чтобы настроить языковые настройки для отдельных приложений в более ранних версиях Android, вам по-прежнему нужно использовать API и встроенные окна выбора языка.

Чтобы включить автоматическую поддержку языков для каждого приложения, укажите локаль по умолчанию:

1. В папке res модуля приложения создайте новый файл с названием resources.properties.

2. В файле resources.properties задайте локаль по умолчанию с помощью ярлыка unqualifiedResLocale. Чтобы создать название локали, объедините код языка с кодами скрипта и региона (если они есть), разделяя их дефисом:

   • Язык: используйте двух- или трехбуквенный код по стандарту ISO 639-1.
   • Набор символов (необязательно). Используйте код ISO 15924.
   • Регион (необязательно). Используйте двухбуквенный код ISO 3166-1 alpha-2 или трехзначный код UN_M.49.

   Например, если в качестве региональных настроек по умолчанию выбран американский английский,

       unqualifiedResLocale=en-US
       

AGP добавляет эти региональные настройки по умолчанию и все указанные вами альтернативные региональные настройки, используя каталоги values-* в папке res, в созданный автоматически файл LocaleConfig.

Автоматическая поддержка языков для приложений по умолчанию отключена. Чтобы включить эту функцию, используйте параметр generateLocaleConfig в блоке androidResources {} файла build.gradle.kts на уровне модуля (build.gradle, если вы используете Groovy):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android Lint содержит байт-код, предназначенный для JVM 17

Начиная с версии 8.1.0-alpha04, Android Lint содержит байт-код, предназначенный для JVM 17. Если вы пишете собственные проверки Lint, вам нужно скомпилировать код с помощью JDK 17 или более поздней версии и указать jvmTarget = '17' в параметрах компилятора Kotlin.

Подробнее об инструменте lint…

Настройки сжатия общей библиотеки C/C++ перенесены в DSL

Начиная с версии AGP 8.1.0-alpha10, вы будете получать предупреждение, если не настроите сжатие общей библиотеки C/C++ с помощью DSL вместо манифеста. Ниже рассказывается, как изменить конфигурацию, чтобы использовать DSL. Чтобы получить помощь с этими обновлениями, используйте помощника по обновлению AGP (Инструменты > Помощник по обновлению AGP).

Чтобы использовать несжатые общие библиотеки C/C++, удалите атрибут android::extractNativeLibs из манифеста и добавьте следующий код в файл build.gradle.kts на уровне модуля (файл build.gradle, если вы используете Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Экспериментальные флаги сборки

Это экспериментальные флаги для настройки сборки, доступные в AGP 8.1.

Устраненные проблемы

Плагин Android Gradle 8.1.4

Плагин Android Gradle 8.1.3

Плагин Android Gradle 8.1.2

Плагин Android Gradle 8.1.1

Плагин Android Gradle 8.1.0