Плагин 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.

Дополнительные сведения об инструменте проверки см. в разделе «Улучшите свой код с помощью проверок» .

Настройки сжатия встроенной библиотеки перенесены в 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