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

Android Gradle plugin 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 метки ResLocale. Для формирования названий локалей объедините код языка с необязательными кодами скрипта и региона, разделяя их дефисом:

   • Язык: Используйте двух- или трехбуквенный код 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. Если вы пишете собственные проверки линтера, вам необходимо компилировать с 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.4

Плагин Android Gradle 8.1.3

Плагин Android Gradle 8.1.2

Плагин Android Gradle 8.1.1

Плагин Android Gradle 8.1.0