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

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

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

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

В новых проектах для настройки сборки по умолчанию используется Kotlin DSL ( build.gradle.kts ). Это обеспечивает более удобный интерфейс редактирования, чем Groovy DSL ( build.gradle ), с подсветкой синтаксиса, автодополнением кода и навигацией по объявлениям. Обратите внимание: если вы используете 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

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

Дополнительную информацию об инструменте lint см. в статье Улучшите свой код с помощью проверок lint .

Настройка сжатия собственной библиотеки перенесена в DSL

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

Чтобы использовать несжатые собственные библиотеки, удалите атрибут 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.0

Плагин Android Gradle 8.1.1

Плагин Android Gradle 8.1.2

Плагин Android Gradle 8.1.3

Плагин Android Gradle 8.1.4