Заметки о выпуске предварительной версии плагина Android Gradle

На этой странице содержатся заметки о выпуске предварительных версий плагина Android Gradle (AGP).

Плагин Android Gradle 9.0

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

Чтобы обновить плагин Android Gradle до версии 9.0.0-alpha05, используйте помощник по обновлению плагина Android Gradle в Android Studio Narwhal 4 Feature Drop | 2025.1.4.

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

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

Максимальный уровень API Android, поддерживаемый плагином Android Gradle 9.0.0-alpha05, — это уровень API 36.

Для плагина Android Gradle 9.0.0-alpha05 требуется Gradle 9.0.0 .

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

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

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

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

• Переключитесь на встроенный Kotlin : плагин org.jetbrains.kotlin.android несовместим с новым DSL.

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

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

• Обновите свою пользовательскую логику сборки, добавив ссылки на новый DSL и API: замените все ссылки на внутренний DSL на публичные интерфейсы DSL. В большинстве случаев это будет однозначная замена. Замените любое использование applicationVariants и подобных API на новый API androidComponents . Это может быть сложнее, поскольку API androidComponents разработано для большей стабильности и более длительной совместимости плагинов. Примеры см. в наших рецептах Gradle .

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

Если вы обновляетесь до 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

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

На этапе альфа-тестирования версии 9.0 мы обращаемся к авторам плагинов, чтобы помочь им адаптировать и выпустить плагины, полностью совместимые с новыми режимами, а также улучшим Помощника по обновлению AGP в Android Studio, который поможет вам выполнить миграцию.

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

Встроенный Kotlin

Плагин Android Gradle 9.0 включает встроенную поддержку компиляции Kotlin, заменяя отдельно устанавливаемый плагин Kotlin. Это упрощает интеграцию с AGP, исключая использование устаревших API и повышая производительность в некоторых случаях.

Плагин Android Gradle 9.0 имеет зависимость времени выполнения от плагина Kotlin Gradle 2.2.10, который является минимальной версией, необходимой для встроенной поддержки Kotlin.

Вы можете отказаться от встроенного Kotlin, установив android.builtInKotlin=false .

Если вы отказались от встроенного Kotlin и вам также необходимо использовать более старую версию плагина Kotlin Gradle, вы можете принудительно перейти на более раннюю версию:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

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

Плагин Android Gradle 9.0 имеет следующие новые возможности:

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

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

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

Плагин Android Gradle 9.0 удаляет следующие функции:

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

Измененный DSL

В плагине Android Gradle 9.0 имеются следующие критические изменения DSL:

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

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

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

  АГП 8.13

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

  АГП 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 удаляет:

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

• AndroidSourceSet.jni , поскольку он не работал.

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

• BuildType.isRenderscriptDebuggable , поскольку он не работал.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Удаленные API

Плагин Android Gradle 9.0 удаляет:

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

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

Принудительные свойства Gradle

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

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