Плагин Android Gradle 4.2.0 (март 2021 г.)

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

Новые функции

Эта версия плагина Android Gradle включает в себя следующие новые функции.

Версия языка Java 8 по умолчанию

Начиная с версии 4.2, AGP по умолчанию будет использовать уровень языка Java 8. Java 8 предоставляет доступ к ряду новых языковых функций, включая лямбда-выражения, ссылки на методы и статические интерфейсные методы. Полный список поддерживаемых функций см. в документации Java 8 .

Чтобы сохранить старое поведение, явно укажите Java 7 в файле build.gradle.kts или build.gradle на уровне модуля:

// build.gradle
android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_7
    targetCompatibility JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

// build.gradle.kts
android {
  ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_7
    targetCompatibility = JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

Новый компилятор ресурсов JVM

Новый компилятор ресурсов JVM в плагине Android Gradle 4.2 заменяет часть компилятора ресурсов AAPT2 , потенциально повышая производительность сборки, особенно на компьютерах с Windows. Новый компилятор ресурсов JVM включен по умолчанию.

Теперь поддерживается подписывание v3 и v4

Плагин Android Gradle 4.2 теперь поддерживает форматы подписи APK v3 и APK v4 . Чтобы включить один или оба этих формата в своей сборке, добавьте следующие свойства в файл build.gradle или build.gradle.kts на уровне модуля:

// build.gradle
android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}

// build.gradle.kts
android {
  ...
  signingConfigs {
      config {
          ...
          enableV3Signing = true
          enableV4Signing = true
      }
  }
}

Подписание APK v4 позволяет быстро развертывать большие APK с помощью инкрементной установки APK ADB в Android 11. Этот новый флаг учитывает этап подписания APK в процессе развертывания.

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

Теперь можно включить или отключить подпись приложений в плагине Android Gradle для каждого варианта.

В этом примере показано, как настроить подпись приложения для каждого варианта с помощью метода onVariants() в Kotlin или Groovy:

androidComponents {
    onVariants(selector().withName("fooDebug"), {
        signingConfig.enableV1Signing.set(false)
        signingConfig.enableV2Signing.set(true)
    })

Новое свойство Gradle: android.native.buildOutput

Чтобы уменьшить загромождение вывода сборки, AGP 4.2 фильтрует сообщения от нативных сборок, использующих CMake и ndk-build , отображая по умолчанию только вывод компилятора C/C++. Ранее для каждого собранного файла формировалась отдельная строка вывода, что приводило к появлению большого количества информационных сообщений.

Если вы хотите увидеть весь вывод собственных данных, задайте новому свойству Gradle android.native.buildOutput значение verbose .

Вы можете задать это свойство либо в файле gradle.properties , либо через командную строку.

gradle.properties
android.native.buildOutput=verbose

Командная строка
-Pandroid.native.buildOutput=verbose

Значение этого свойства по умолчанию — quiet .

Изменение поведения файлов gradle.properties

Начиная с версии AGP 4.2, переопределение свойств Gradle из подпроектов больше невозможно. Другими словами, если объявить свойство в файле gradle.properties в подпроекте, а не в корневом проекте, оно будет проигнорировано.

Например, в предыдущих выпусках AGP считывал значения из <var>projectDir</var>/gradle.properties , <var>projectDir</var>/app/gradle.properties , <var>projectDir</var>/library/gradle.properties и т. д. Для модулей приложений, если одно и то же свойство Gradle присутствовало как в <var>projectDir</var>/gradle.properties , так и <var>projectDir</var>/app/gradle.properties , значение из <var>projectDir</var>/app/gradle.properties имело приоритет.

В AGP 4.2 это поведение было изменено, и AGP больше не будет загружать значения из gradle.properties в подпроектах (например, <var>projectDir</var>/app/gradle.properties ). Это изменение отражает новое поведение Gradle и поддерживает кэширование конфигурации.

Дополнительную информацию о настройке значений в файлах gradle.properties см. в документации Gradle .

Совместимость Gradle и изменения конфигурации

При работе в Android Studio инструмент сборки Gradle использует встроенный JDK Studio. В предыдущих выпусках в комплект Studio входил JDK 8. Однако в версии 4.2 вместо него в комплект входит JDK 11. Использование нового встроенного JDK для запуска Gradle может привести к некоторой несовместимости или снижению производительности JVM из-за изменений в сборщике мусора. Эти проблемы описаны ниже.

Совместимость Studio с плагином Android Gradle (AGP)

Android Studio 4.2 может открывать проекты, использующие AGP 3.1 и выше, при условии, что AGP работает под управлением Gradle 4.8.1 и выше. Подробнее о совместимости с Gradle см. в разделе Обновление Gradle .

Оптимизация сборок Gradle для JDK 11

Это обновление JDK 11 влияет на конфигурацию сборщика мусора JVM по умолчанию, поскольку JDK 8 использует параллельный сборщик мусора, а JDK 11 — сборщик мусора G1 .

Для потенциального повышения производительности сборки мы рекомендуем тестировать сборки Gradle с помощью параллельного сборщика мусора. В gradle.properties установите следующие параметры:

org.gradle.jvmargs=-XX:+UseParallelGC

Если в этом поле уже установлены другие параметры, добавьте новый параметр:

org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGC

Чтобы измерить скорость сборки с различными конфигурациями, см. раздел Профилирование сборки .

Файлы DEX распаковываются в APK, если minSdk = 28 или выше

AGP теперь по умолчанию упаковывает несжатые DEX-файлы в APK-файлы при minSdk = 28 или выше. Это приводит к увеличению размера APK-файла, но уменьшает размер установочного файла на устройстве, а размер загружаемого файла практически не меняется.

Чтобы заставить AGP вместо этого упаковывать сжатые файлы DEX, вы можете добавить в файл build.gradle следующее:

android {
    packagingOptions {
        dex {
            useLegacyPackaging true
        }
    }
}

Используйте DSL для упаковки сжатых собственных библиотек

Мы рекомендуем упаковывать нативные библиотеки в несжатом виде, поскольку это уменьшает размер устанавливаемого и загружаемого приложения, а также ускоряет его загрузку для пользователей. Однако, если вы хотите, чтобы плагин Android Gradle упаковывал сжатые нативные библиотеки при сборке приложения, установите для параметра useLegacyPackaging значение true в файле build.gradle вашего приложения:

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

Флаг useLegacyPackaging заменяет атрибут манифеста extractNativeLibs . Подробнее см. в примечании к выпуску «Нативные библиотеки по умолчанию упакованы без сжатия» .