Плагин Android Gradle 9.0.1 (январь 2026 г.)

Android Gradle plugin 9.0 — это крупный релиз, вносящий изменения в API и поведение программы.

Для обновления до плагина Android Gradle версии 9.0.1 используйте помощник обновления плагина Android Gradle . Помощник обновления AGP помогает сохранить существующее поведение при обновлении проекта, когда это необходимо, поэтому вы можете обновить свой проект до AGP 9.0, даже если вы не готовы принять все новые настройки по умолчанию в AGP 9.0.

Также доступны два навыка агента, которые упростят процесс обновления. Для приложений, не использующих KMP, попробуйте навык обновления AGP 9 из репозитория навыков Android. Для приложений, использующих KMP, попробуйте навык обновления AGP 9 от JetBrains. Дополнительную информацию об использовании навыков в Android Studio см. в разделе «Расширение режима агента с помощью навыков» .

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

Максимальный уровень API, поддерживаемый плагином Android Gradle 9.0, — 36.1. Вот дополнительная информация о совместимости:

В классах android DSL теперь реализованы только новые публичные интерфейсы.

За последние несколько лет мы внедрили новые интерфейсы для нашего DSL и API, чтобы лучше контролировать, какие API являются публичными. В версиях AGP 7.x и 8.x по-прежнему использовались старые типы DSL (например, BaseExtension ), которые также реализовывали новые публичные интерфейсы, чтобы сохранить совместимость по мере развития работы над интерфейсами.

AGP 9.0 использует исключительно наши новые DSL-интерфейсы, а в реализациях используются новые, полностью скрытые типы. Это также исключает доступ к старому, устаревшему API вариантов.

Для обновления до AGP 9.0 может потребоваться выполнить следующие действия:

• Убедитесь, что ваш проект совместим со встроенным Kotlin : плагин org.jetbrains.kotlin.android несовместим с новым DSL.

• Переключитесь на плагин библиотеки Android Gradle для KMP в проектах KMP: использование плагина org.jetbrains.kotlin.multiplatform в том же подпроекте Gradle, что и плагины com.android.library и com.android.application , несовместимо с новым DSL.

• Обновите файлы сборки: хотя изменение интерфейсов призвано сохранить DSL максимально похожим, могут быть некоторые небольшие изменения .

• Update your custom build logic to reference the new DSL and API: Replace any references to the internal DSL with the public DSL interfaces. In most cases this will be a one-to-one replacement. Replace any use of the applicationVariants and similar APIs with the new androidComponents API . This might be more complex, as the androidComponents API is designed to be more stable to keep plugins compatible longer. Check our Gradle Recipes for examples.

• Обновите сторонние плагины: некоторые сторонние плагины могут по-прежнему зависеть от интерфейсов или API, которые больше не доступны. Перейдите на версии этих плагинов, совместимые с AGP 9.0.

Переход на новые DSL-интерфейсы предотвращает использование плагинами и скриптами сборки Gradle различных устаревших API, в том числе:

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

Если после обновления до AGP 9.0 вы видите следующее сообщение об ошибке, это означает, что ваш проект по-прежнему ссылается на некоторые старые типы:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

Если вас блокируют несовместимые сторонние плагины, вы можете отказаться от них и вернуть старые реализации DSL, а также старый вариант API. При этом новые интерфейсы также будут доступны, и вы сможете обновить свою логику сборки в соответствии с новым API. Чтобы отказаться от них, добавьте следующую строку в файл gradle.properties :

android.newDsl=false

В качестве альтернативы, для более постепенной миграции, AGP 9.4 позволяет отказаться от отдельных модулей. Чтобы узнать, как это сделать, см. раздел «Отказ от модулей Variant API» .

В AGP 9.0 предыдущие классы помечены как устаревшие. Это означает, что проекты, которые откажутся от флага newDsl будут видеть предупреждения об устаревании, в том числе и в самом блоке android .

Вы также можете начать обновление до новых API до обновления до AGP 9.0. Новые интерфейсы присутствовали во многих версиях AGP, поэтому у вас может быть сочетание новых и старых. В справочной документации по API AGP показан интерфейс API для каждой версии AGP, а также дата добавления каждого класса, метода и поля.

Мы обращаемся к авторам часто используемых плагинов, чтобы помочь им адаптировать и выпустить плагины, полностью совместимые с новыми режимами, и продолжим совершенствовать AGP Upgrade Assistant в Android Studio, чтобы помочь вам в процессе миграции.

Если вы обнаружите, что в новом DSL или API вариантов отсутствуют необходимые возможности или функции, пожалуйста, как можно скорее сообщите об этом, создав соответствующую проблему .

Встроенный Kotlin

В плагине Android Gradle версии 9.0 реализована встроенная поддержка Kotlin, которая включена по умолчанию. Это означает, что вам больше не нужно применять плагин org.jetbrains.kotlin.android (или kotlin-android ) в файлах сборки для компиляции исходных файлов Kotlin. Это упрощает интеграцию Kotlin с AGP, позволяет избежать использования устаревших API и в некоторых случаях повышает производительность.

Поэтому при обновлении проекта до AGP 9.0 вам также необходимо перейти на встроенный Kotlin или отказаться от него .

Вы также можете выборочно отключать встроенную поддержку Kotlin для подпроектов Gradle, которые не содержат исходный код на Kotlin.

Зависимость от плагина Kotlin Gradle во время выполнения

To provide built-in Kotlin support, Android Gradle plugin 9.0 now has a runtime dependency on Kotlin Gradle plugin (KGP) 2.2.10. That means you no longer have to declare a KGP version, and if you use a KGP version lower than 2.2.10, Gradle will automatically upgrade your KGP version to 2.2.10. Likewise, if you use a KSP version lower than 2.2.10-2.0.2, AGP will upgrade it to 2.2.10-2.0.2 to match the KGP version.

Обновите KGP до более новой версии.

Для использования более новой версии KGP или KSP добавьте следующее в главный файл сборки:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

Понизьте версию KGP до более старой.

Понижение версии KGP возможно только в том случае, если вы отказались от встроенного Kotlin . Это связано с тем, что AGP 9.0 по умолчанию включает встроенный Kotlin, а для его использования требуется KGP 2.2.10 или выше.

Чтобы использовать более старую версию KGP или KSP, укажите эту версию в файле сборки верхнего уровня, используя строгое указание версии :

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

Обратите внимание, что минимальная версия KGP, до которой можно откатиться, — 2.0.0.

Поддержка тестовых стендов в IDE

AGP 9.0 обеспечивает полную поддержку тестовых наборов в среде разработки Android Studio.

Плагин объединенной библиотеки

Плагин Fused Library (предварительная версия) позволяет публиковать несколько библиотек в виде единого Android Library AAR-файла. Это может упростить пользователям использование опубликованных вами артефактов.

Для получения информации о начале работы см. раздел «Публикация нескольких библиотек Android как одной с помощью Fused Library» .

Изменения в поведении

В плагине Android Gradle версии 9.0 появились следующие новые возможности:

В AGP 9.0 внесены изменения в значения по умолчанию для следующих свойств Gradle. Это позволяет сохранить поведение AGP 8.13 при обновлении:

android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

Удалённые функции

В плагине Android Gradle версии 9.0 удалена следующая функциональность:

• Поддержка приложений Embedded Wear OS
  В AGP 9.0 прекращена поддержка встраивания приложений Wear OS, которая больше не поддерживается в Play Store. Это включает в себя удаление конфигураций wearApp и DSL AndroidSourceSet.wearAppConfigurationName . Инструкции по публикации приложения в Wear OS см. в разделе «Распространение в Wear OS».
• задача отчета androidDependencies и sourceSets Android
• Поддержка разделения по плотности APK
  В AGP 9.0 удалена поддержка создания разделенных APK-файлов на основе плотности экрана. Функциональность и связанные с ней API были удалены. Для разделения APK-файлов на основе плотности экрана с использованием AGP 9.0 или более поздних версий используйте пакеты приложений .

Изменен DSL

В плагине Android Gradle версии 9.0 внесены следующие изменения в DSL, нарушающие совместимость:

• Параметризация CommonExtension удалена.

  Само по себе это всего лишь изменение на уровне исходного кода, призванное предотвратить подобные изменения в будущем, но оно также означает, что методы блока необходимо перенести из CommonExtension в ApplicationExtension , LibraryExtension , DynamicFeatureExtension и TestExtension .

  При обновлении проекта до AGP 9.0 проведите рефакторинг кода плагина Gradle, использующего эти параметры или методы блоков. Например, следующий плагин обновлен таким образом, чтобы удалить параметр типа и не полагаться на удаленные методы блоков:

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  Для плагинов, ориентированных на широкий диапазон версий AGP, прямое использование геттера обеспечивает бинарную совместимость с версиями AGP ниже 9.0.

Удалён DSL

В плагине Android Gradle версии 9.0 удалены следующие изменения:

• Файл AndroidSourceSet.jni не работал.

• AndroidSourceSet.wearAppConfigurationName , в связи с удаленной поддержкой встроенного приложения Wear OS.

• BuildType.isRenderscriptDebuggable , потому что он не работал.

• DependencyVariantSelection . Он заменяется на DependencySelection , который доступен как kotlin.android.localDependencySelection

• Installation.installOptions(String) . Оно заменяется изменяемым свойством Installation.installOptions .

• Экспериментальный, но так и не стабилизированный блок PostProcessing .

• ProductFlavor.setDimension заменяется свойством dimension .

• LanguageSplitOptions , который был полезен только для Google Play Instant , устарел.

• DensitySplit , поскольку эта функция больше не поддерживается. В качестве замены можно использовать App Bundles .

Удалённые API

В плагине Android Gradle версии 9.0 удалены следующие изменения:

• AndroidComponentsExtension.finalizeDSl . Он заменяется на finalizeDsl

• Component.transformClassesWith . Он заменяется на Instrumentation.transformClassesWith

• Component.setAsmFramesComputationMode . Заменяется на Instrumentation.setAsmFramesComputationMode

• ComponentBuilder.enabled . Заменяется на ComponentBuilder.enable .

• DependenciesInfoBuilder.includedInApk заменяется на includeInApk

• DependenciesInfoBuilder.includedInBundle заменяется на includeInBundle .

• GeneratesApk.targetSdkVersion заменяется на targetSdk

• Variant.minSdkVersion заменяется на minSdk

• Variant.maxSdkVersion заменяется на maxSdk

• Variant.targetSdkVersion заменяется на targetSdk

• Variant.unitTest , поскольку он не был применим к плагину com.android.test . unitTest доступен для подтипов VariantBuilder , расширяющих HasUnitTest .

• VariantBuilder.targetSdk и targetSdkPreview не имели смысла в библиотеках. Вместо них используйте GeneratesApkBuilder.targetSdk или GeneratesApkBuilder.targetSdkPreview .

• VariantBuilder.enableUnitTest был недоступен для плагина com.android.test . enableUnitTest доступен для подтипов VariantBuilder наследующих HasUnitTestBuilder .

• VariantBuilder.unitTestEnabled удален в пользу более согласованного по названию enableUnitTest в подтипах VariantBuilder наследующих HasUnitTestBuilder .

• VariantOutput.enable заменяется на enabled .

• Устаревшие и отключенные FeaturePlugin и FeatureExtension .

• Устаревшие и отключенные API-интерфейсы BaseExtension.registerTransform , которые остались только для обеспечения возможности компиляции с использованием последней версии AGP при работе на AGP 4.2 или ниже.

Удалены свойства Gradle

Следующие свойства Gradle были первоначально добавлены для глобального отключения функций, которые были включены по умолчанию.

Эти функции отключены по умолчанию начиная с AGP 8.0 и ниже. Для более эффективной сборки включайте эти функции только в тех подпроектах, которые их используют.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Объекты с принудительной регулировкой уровня грунта

В AGP 9.0 возникает ошибка, если задать следующие свойства Gradle.

Плагин Android Gradle Upgrade Assistant не будет обновлять до AGP 9.0 проекты, использующие эти свойства.

Изменения в R8

В AGP 9.0.0 включены следующие изменения R8.

Новая опция конфигурации -processkotlinnullchecks

Мы добавили новую опцию R8 -processkotlinnullchecks для настройки R8 на обработку проверок на null в Kotlin. Эта опция принимает обязательный аргумент, который должен принимать одно из следующих трех значений: keep , remove_message и remove . Опция обрабатывает следующие проверки на null, добавленные компилятором Kotlin:

class kotlin.jvm.internal.Intrinsics {
  void checkNotNull(java.lang.Object);
  void checkNotNull(java.lang.Object, java.lang.String);
  void checkExpressionValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkNotNullExpressionValue(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkFieldIsNotNull(java.lang.Object, java.lang.String);
  void checkFieldIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkParameterIsNotNull(java.lang.Object, java.lang.String);
  void checkNotNullParameter(java.lang.Object, java.lang.String);
}

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

• keep не изменяет результаты проверок.
• remove_message переписывает каждый вызов метода проверки на вызов метода getClass() для первого аргумента вызова (фактически сохраняя проверку на null, но без какого-либо сообщения).
• remove полностью снимает все проверки.

По умолчанию в R8 используется remove_message . Любое указание параметра -processkotlinnullchecks переопределит это значение. Если параметр указан несколько раз, используется наиболее строгое значение.

Прекратите распространение информации о сохранении данных с помощью сопутствующих методов.

Когда правила сохранения соответствуют методам интерфейса, которые подлежат десахаризации, R8 предварительно внутренне передавал биты запрета оптимизации и запрета сжатия синтезированным сопутствующим методам.

Начиная с AGP 9.0, правила сохранения больше не применяются к сопутствующим методам. Это соответствует тому факту, что правила сохранения не применяются к другим полям/методам/классам, синтезируемым компилятором.

Благодаря переносу функций запрета оптимизации и запрета уменьшения битов в сопутствующие методы, ранее поддерживался следующий вариант использования:

1. Скомпилируйте библиотеку с методами интерфейса default / static / private методами в DEX с minSdk < 24 и правилами, которые сохраняют методы интерфейса.
2. Скомпилируйте приложение, добавив библиотеку в classpath и -applymapping .
3. Объедините приложение и библиотеку.

Обратите внимание, что это работает только с -applymapping поскольку бит disallow obfuscation не передается на сопутствующие методы — то есть, сопутствующие классы, сгенерированные на шаге 1, будут иметь обфусцированные имена методов.

В дальнейшем этот вариант использования больше не поддерживается для minSdk < 24. В качестве обходного пути можно выполнить следующие действия:

1. Десахаризация библиотеки с методами интерфейса default / static / private методами в файлах классов с minSdk < 24.
2. Скомпилируйте десахаризованный артефакт, используя R8 и правила, которые сохраняют методы интерфейса в сопутствующих классах.
3. Скомпилируйте приложение, добавив библиотеку в classpath.
4. Объедините приложение и десахаризованный артефакт.

Ещё одним побочным эффектом этого является невозможность сохранения атрибутов внутреннего класса и объемлющего метода для анонимных и локальных классов внутри сопутствующих методов интерфейса.

Измените исходный файл, генерируемый по умолчанию, на r8-map-id-<MAP_ID>

Это изменение внесено в AGP начиная с версии 8.12.0.

Атрибут исходного файла, генерируемого по умолчанию для класса, изменяется с SourceFile на r8-map-id-<MAP_ID> когда требуется трассировка (то есть, когда включено обфускация или оптимизация).

При наличии зашифрованного трассировочного стека новый атрибут исходного файла позволяет извлечь идентификатор файла сопоставления, необходимого для повторной трассировки, что может быть использовано для поддержки автоматической повторной трассировки трассировочных стеков в Logcat .

Если используется пользовательский атрибут исходного файла ( -renamesourcefileattribute ), этот пользовательский атрибут исходного файла продолжает иметь приоритет.

In ProGuard compatibility mode (when gradle.properties contains android.enableR8.fullMode=false ), emitting a source file attribute of r8-map-id-<MAP_ID> only takes effect if the SourceFile attribute is not kept. Apps that use ProGuard compatibility mode and want to include the mapping file ID in their stack traces should remove -keepattributes SourceFile (or migrate to R8 full mode).

В r8-map-id-<MAP_ID> используется полный хеш карты, а не 7-символьный префикс хеша карты, который использовался ранее.

Разрешить использование сокращенных синтетических названий при десахарировании L8.

Имена синтетических классов, генерируемых D8, обычно содержат подстроку $$ExternalSynthetic которая указывает на то, что это синтетический класс, сгенерированный D8. Более того, имя синтетического класса также кодирует его тип (например, Backport , Lambda ). Это негативно влияет на размер результирующего DEX-файла, поскольку имена классов занимают больше места в пуле строк.

AGP 9.0 настраивает L8 (десахаризацию основной библиотеки) таким образом, что DEX-файл, содержащий все классы j$ использует новый сокращенный формат имен классов для синтетических классов. Новое имя класса использует числовой идентификатор (например, $1 ).

Удалена поддержка параметра -addconfigurationdebugging

В AGP 9.0 удалена поддержка флага -addconfigurationdebugging . Теперь компилятор выдает предупреждение, если этот флаг используется.

Удалить поддержку генерации правил L8 из D8/R8

Это изменение актуально только для разработчиков, использующих командную строку D8/R8 или API напрямую.

В версии R8 9.0 удалена поддержка генерации правил сохранения для L8 из D8 и R8. Вместо этого для этой цели следует использовать TraceReferences .

В частности, методы D8Command.builder.setDesugaredLibraryKeepRuleConsumer и R8Command.Builder.setDesugaredLibraryKeepRuleConsumer удалены, а поддержка параметра --desugared-lib-pg-conf-output удалена из параметров командной строки D8 и R8.

Исправлены ошибки

Android Gradle plugin 9.0.0

Android Gradle plugin 9.0 is a major release that brings API and behavior changes.

To update to Android Gradle plugin 9.0.1, use the Android Gradle plugin Upgrade Assistant . The AGP upgrade assistant helps preserve existing behaviors when upgrading your project whenever appropriate, so you can upgrade your project to use AGP 9.0 even if you're not ready to adopt all the new defaults in AGP 9.0.

There are also two agent skills available to make the upgrade process easier. For a non-KMP app, try the AGP 9 upgrade skill from the Android skills repository. For a KMP app, try the AGP 9 upgrade skill from JetBrains. For more information about using skills in Android Studio, see Extend Agent Mode with skills .

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

The maximum API level that Android Gradle plugin 9.0 supports is API level 36.1. Here is other compatibility info:

The android DSL classes now only implement the new public interfaces

Over the last several years, we have introduced new interfaces for our DSL and API in order to better control which APIs are public. AGP versions 7.x and 8.x still used the old DSL types (for example BaseExtension ) which also implemented the new public interfaces, in order to maintain compatibility as work progressed on the interfaces.

AGP 9.0 uses our new DSL interfaces exclusively, and the implementations have changed to new types that are fully hidden. This also removes access to the old, deprecated variant API.

To update to AGP 9.0, you might need to do the following:

• Ensure your project is compatible with built-in Kotlin : The org.jetbrains.kotlin.android plugin is not compatible with the new DSL.

• Switch KMP projects to the Android Gradle Library Plugin for KMP : Using the org.jetbrains.kotlin.multiplatform plugin in the same Gradle subproject as the com.android.library and com.android.application plugins is not compatible with the new DSL.

• Update your build files: While the change of interfaces is meant to keep the DSL as similar as possible, there might be some small changes .

• Update your custom build logic to reference the new DSL and API: Replace any references to the internal DSL with the public DSL interfaces. In most cases this will be a one-to-one replacement. Replace any use of the applicationVariants and similar APIs with the new androidComponents API . This might be more complex, as the androidComponents API is designed to be more stable to keep plugins compatible longer. Check our Gradle Recipes for examples.

• Update third-party plugins: Some third-party plugins might still depend on interfaces or APIs that are no longer exposed. Migrate to versions of those plugins which are compatible with AGP 9.0.

The switch to the new DSL interfaces prevents plugins and Gradle build scripts using various deprecated APIs, including:

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

If you update to AGP 9.0 and see the following error message, it means that your project is still referencing some of the old types:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

If you are blocked by incompatible third-party plugins, you can opt out and get back the old implementations for the DSL, as well as the old variant API. While doing this, the new interfaces are also available, and you can still update your own build logic to the new API. To opt out, include this line in your gradle.properties file:

android.newDsl=false

Alternatively, for a more gradual migration, AGP 9.4 lets you opt out individual modules. To learn how, see Variant API module opt-out .

The previous classes are marked as deprecated in AGP 9.0. This means projects that opt out of the newDsl flag will see deprecation warnings, including on the android block itself.

You can also start upgrading to the new APIs before upgrading to AGP 9.0. The new interfaces have been present for many AGP versions and so you can have a mix of new and old. The AGP API reference docs show the API surface for each AGP version, and when each class, method and field was added.

We're reaching out to the authors of commonly used plugins to help them adapt and release plugins that are fully compatible with the new modes, and will continue to enhance the AGP Upgrade Assistant in Android Studio to guide you through the migration.

If you find that the new DSL or Variant API are missing capabilities or features, please file an issue as soon as possible.

Built-in Kotlin

Android Gradle plugin 9.0 introduces built-in Kotlin support and enables it by default. That means you no longer have to apply the org.jetbrains.kotlin.android (or kotlin-android ) plugin in your build files to compile Kotlin source files. This simplifies the Kotlin integration with AGP, avoids the use of deprecated APIs, and improves performance in some cases.

Therefore, when you upgrade your project to AGP 9.0, you need to also migrate to built-in Kotlin or opt out .

You can also selectively disable built-in Kotlin support for Gradle subprojects that don't have Kotlin sources.

Runtime dependency on Kotlin Gradle plugin

To provide built-in Kotlin support, Android Gradle plugin 9.0 now has a runtime dependency on Kotlin Gradle plugin (KGP) 2.2.10. That means you no longer have to declare a KGP version, and if you use a KGP version lower than 2.2.10, Gradle will automatically upgrade your KGP version to 2.2.10. Likewise, if you use a KSP version lower than 2.2.10-2.0.2, AGP will upgrade it to 2.2.10-2.0.2 to match the KGP version.

Upgrade to a higher KGP version

To use a higher version of KGP or KSP, add the following to your top-level build file:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

Downgrade to a lower KGP version

You can only downgrade the KGP version if you've opted out of built-in Kotlin . This is because AGP 9.0 enables built-in Kotlin by default, and built-in Kotlin requires KGP 2.2.10 or higher.

To use a lower version of KGP or KSP, declare that version in your top-level build file using a strict version declaration:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

Note that the minimum KGP version you can downgrade to is 2.0.0.

IDE support for test fixtures

AGP 9.0 brings full Android Studio IDE support for test fixtures .

Fused Library Plugin

The Fused Library Plugin (Preview) lets you publish multiple libraries as a single Android Library AAR. This can make it easier for your users to depend on your published artifacts.

For information about getting started, see Publish multiple Android libraries as one with Fused Library .

Изменения в поведении

Android Gradle plugin 9.0 has the following new behaviors:

AGP 9.0 includes updates to the following Gradle properties' defaults. This gives you the choice to preserve the AGP 8.13 behavior when upgrading:

android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

Удалённые функции

Android Gradle plugin 9.0 removes the following functionality:

• Embedded Wear OS app support
  AGP 9.0 removes support for embedding Wear OS apps, which is no longer supported in Play. This includes removing the wearApp configurations and the AndroidSourceSet.wearAppConfigurationName DSL. See Distribute to Wear OS for how to publish your app to Wear OS.
• androidDependencies and sourceSets report task
• Density split APK support
  AGP 9.0 removes support for creating split APKs based on screen density. The functionality and the related APIs have been removed. To split APKs based on screen density using AGP 9.0 or higher, use app bundles .

Changed DSL

Android Gradle plugin 9.0 has the following breaking DSL changes:

• The parameterization of CommonExtension has been removed.

  In itself, this is only a source-level breaking change to help avoid future source-level breaking changes, but it also means that the block methods need to move from CommonExtension to ApplicationExtension , LibraryExtension , DynamicFeatureExtension and TestExtension .

  When upgrading your project to AGP 9.0, refactor Gradle plugin code which uses those parameters or the block methods. For example the following plugin is updated to remove the type parameter and not rely on the removed block methods:

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  For plugins which target a range of AGP versions, using the getter directly is binary compatible with AGP versions lower than 9.0.

Removed DSL

Android Gradle plugin 9.0 removes:

• AndroidSourceSet.jni , because it was not functional.

• AndroidSourceSet.wearAppConfigurationName , as it relates to the removed embedded Wear OS app support.

• BuildType.isRenderscriptDebuggable , because it was not functional.

• DependencyVariantSelection . It is replaced By DependencySelection , which is exposed as kotlin.android.localDependencySelection

• Installation.installOptions(String) . It is replaced by the mutable property of Installation.installOptions .

• The experimental, but never stabilized PostProcessing block.

• ProductFlavor.setDimension , which is replaced by the dimension property

• LanguageSplitOptions , which was only useful for Google Play Instant , which is deprecated.

• DensitySplit , because the feature is no longer supported. Replacement is to use App Bundles .

Удалённые API

Android Gradle plugin 9.0 removes:

• AndroidComponentsExtension.finalizeDSl . It is replaced by finalizeDsl

• Component.transformClassesWith . It is replaced by Instrumentation.transformClassesWith

• Component.setAsmFramesComputationMode . It is replaced by Instrumentation.setAsmFramesComputationMode

• ComponentBuilder.enabled . It is replaced by ComponentBuilder.enable .

• DependenciesInfoBuilder.includedInApk . Is is replaced by includeInApk

• DependenciesInfoBuilder.includedInBundle . Is is replaced by includeInBundle

• GeneratesApk.targetSdkVersion . Is is replaced by targetSdk

• Variant.minSdkVersion . Is is replaced by minSdk

• Variant.maxSdkVersion . Is is replaced by maxSdk

• Variant.targetSdkVersion . Is is replaced by targetSdk

• Variant.unitTest , as it was not applicable to the com.android.test plugin. unitTest is available on VariantBuilder subtypes extending HasUnitTest .

• VariantBuilder.targetSdk and targetSdkPreview , as they were not meaningful in libraries. Use GeneratesApkBuilder.targetSdk or GeneratesApkBuilder.targetSdkPreview instead.

• VariantBuilder.enableUnitTest , as it was not applicable to the com.android.test plugin. enableUnitTest is available on VariantBuilder subtypes extending HasUnitTestBuilder .

• VariantBuilder.unitTestEnabled is removed in favor of the more consistently named enableUnitTest on the VariantBuilder subtypes extending HasUnitTestBuilder .

• VariantOutput.enable . Is is replaced by enabled

• The deprecated and disabled FeaturePlugin and FeatureExtension .

• The deprecated and disabled BaseExtension.registerTransform APIs, which only remained to allow compiling against the latest AGP version while targeting running on AGP 4.2 or lower.

Removed Gradle properties

The following Gradle properties were initially added as ways to globally disable features that were enabled by default.

These features have been disabled by default since AGP 8.0 or lower. Enable these features in only the sub-projects that use them for a more efficient build.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Enforced Gradle properties

AGP 9.0 throws an error if you set the following Gradle properties.

The Android Gradle plugin Upgrade Assistant won't upgrade projects to AGP 9.0 that use these properties.

R8 changes

The following R8 changes are included in AGP 9.0.0.

New configuration option -processkotlinnullchecks

We've added the new R8 option -processkotlinnullchecks to configure R8 for processing Kotlin null checks. The option takes a mandatory argument that must be one of the following three values: keep , remove_message and remove . The option processes the following null checks added by the Kotlin compiler:

class kotlin.jvm.internal.Intrinsics {
  void checkNotNull(java.lang.Object);
  void checkNotNull(java.lang.Object, java.lang.String);
  void checkExpressionValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkNotNullExpressionValue(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkFieldIsNotNull(java.lang.Object, java.lang.String);
  void checkFieldIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkParameterIsNotNull(java.lang.Object, java.lang.String);
  void checkNotNullParameter(java.lang.Object, java.lang.String);
}

The option values, ordered from the weakest to the strongest, have the following effect:

• keep doesn't change the checks.
• remove_message rewrites each check method call to a call to getClass() on the first argument of the call (effectively keeping the null check, but without any message).
• remove completely removes the checks.

By default R8 uses remove_message . Any specification of -processkotlinnullchecks will override that. If specified multiple times the strongest value is used.

Stop propagating keep info to companion methods

When keep rules match interface methods that are subject to desugaring, R8 previously internally transferred the disallow optimization and disallow shrinking bits to the synthesized companion methods.

Starting with AGP 9.0, keep rules no longer apply to companion methods. This is consistent with the fact that keep rules are not applicable to other compiler synthesized fields/methods/classes.

By transferring the disallow optimization and disallow shrinking bits to the companion methods, the following use case was previously supported:

1. Compile a library with default / static / private interface methods to DEX with minSdk < 24 and rules that keep the interface methods.
2. Compile an app with the library on classpath and -applymapping .
3. Merge the app and the library.

Note that this only works with -applymapping since the disallow obfuscation bit is not transferred to the companion methods—that is, the companion classes generated from step 1 would have obfuscated method names.

Going forward this use case is no longer supported for minSdk < 24. The workaround is to do the following:

1. Desugar the library with default / static / private interface methods to class files with minSdk < 24.
2. Compile the desugared artifact using R8 and rules that keep the interface methods on the companion classes.
3. Compile the app with the library on classpath.
4. Merge the app and the desugared artifact.

Another side effect of this is that it is no longer possible to keep the inner class and enclosing method attributes for anonymous and local classes inside interface companion methods.

Change the default emitted source file to r8-map-id-<MAP_ID>

This change is in AGP starting from 8.12.0.

The default emitted source file attribute for a class changes from SourceFile to r8-map-id-<MAP_ID> when retracing is required (that is, when either obfuscation or optimization is enabled).

Given an obfuscated stack trace, the new source file attribute makes it possible to extract the ID of the mapping file that is required for retracing, which can be used to support automated retracing of stack traces in Logcat .

If a custom source file attribute is used ( -renamesourcefileattribute ) this custom source file attribute continues to take precedence.

In ProGuard compatibility mode (when gradle.properties contains android.enableR8.fullMode=false ), emitting a source file attribute of r8-map-id-<MAP_ID> only takes effect if the SourceFile attribute is not kept. Apps that use ProGuard compatibility mode and want to include the mapping file ID in their stack traces should remove -keepattributes SourceFile (or migrate to R8 full mode).

The map ID used in r8-map-id-<MAP_ID> is the full map hash, and not a 7 character prefix of the map hash which was previously used.

Enable use of minimized synthetic names in L8 desugaring

The name of synthetic classes generated by D8 normally contains the substring $$ExternalSynthetic that tells you that this is a synthetic generated by D8. Moreover, the name of the synthetic also encodes the synthetic kind (for example, Backport , Lambda ). This has a negative impact on the resulting DEX size, since the class names take up more space in the string pool.

AGP 9.0 configures L8 (core library desugaring) so that the DEX file containing all j$ classes uses a new shortened class name format for synthetic classes. The new class name uses a numeric ID (for example, $1 ).

Remove support for -addconfigurationdebugging

AGP 9.0 removes support for -addconfigurationdebugging . The compiler now reports a warning if the flag is used.

Remove support for generating L8 rules from D8/R8

This change is only relevant for developers using the D8/R8 command line or APIs directly.

R8 9.0 removes support for generating keep rules for L8 from D8 and R8. You should instead use TraceReferences for this purpose.

More specifically, the methods D8Command.builder.setDesugaredLibraryKeepRuleConsumer and R8Command.Builder.setDesugaredLibraryKeepRuleConsumer are removed, and the support for --desugared-lib-pg-conf-output is removed from the command line options of D8 and R8.

Исправлены ошибки

Android Gradle plugin 9.0.0