Android Gradle 플러그인 미리보기 출시 노트

이 페이지에는 Android Gradle 플러그인 (AGP)의 미리보기 버전 출시 노트가 포함되어 있습니다.

Android Gradle 플러그인 9.0

Android Gradle 플러그인 9.0은 AGP의 새로운 주요 버전으로, API 및 동작 변경사항이 적용됩니다.

Android Gradle 플러그인 9.0.0-alpha04로 업데이트하려면 Android 스튜디오 Narwhal 4 Feature Drop | 2025.1.4에서 Android Gradle 플러그인 업그레이드 어시스턴트를 사용하세요.

AGP 업그레이드 어시스턴트는 적절한 경우 프로젝트를 업그레이드할 때 기존 동작을 유지하여 AGP 9.0의 새로운 기본값을 모두 채택할 준비가 되지 않았더라도 AGP 9.0을 사용하도록 프로젝트를 업그레이드할 수 있도록 지원합니다.

호환성

Android Gradle 플러그인 9.0.0-alpha04에서 지원하는 최대 Android API 수준은 API 수준 36입니다.

Android Gradle 플러그인 9.0.0-alpha04에는 Gradle 9.0.0이 필요합니다.

내부 DSL 구현 및 지원 중단된 변형 API에 이제 명시적 선택 필요

이제 Android Gradle 플러그인에 정의된 API 노출 영역이 있으며 지원되는 API는 com.android.tools.build:gradle-api Maven 아티팩트에 정의되어 있습니다.

기존 바이너리 플러그인 및 빌드 스크립트와의 호환성을 위해 정의된 API 노출 영역보다 오래된 이전 DSL 구현은 AGP 8.13 이하에서 기본적으로 계속 노출되었습니다. 이를 통해 Gradle 플러그인 및 빌드 스크립트의 코드가 DSL의 내부 구현 세부정보와 지원 중단된 android.applicationVariants, android.libraryVariants, android.testVariants, android.unitTestVariants API에 모두 액세스할 수 있습니다. 이러한 API는 AGP 10에서 2026년에 삭제될 예정입니다.

이 전환을 더 명확하게 하기 위해 기존 변형 API와 내부 DSL은 기본적으로 Android Gradle 플러그인 9.0.0-alpha04에서 액세스할 수 없습니다.

gradle.properties에서 android.newDsl=false를 설정하여 지원 중단된 API를 다시 사용할 수 있습니다.

9.0 알파 시리즈에서 Google은 플러그인 작성자에게 연락하여 새로운 모드와 완전히 호환되는 플러그인을 적용하고 출시하도록 지원하고 있으며, Android 스튜디오의 AGP 업그레이드 어시스턴트를 개선하여 이전 과정을 안내할 예정입니다.

Kotlin 내장

Android Gradle 플러그인 9에는 Kotlin 컴파일을 위한 지원이 내장되어 별도로 적용된 Kotlin 플러그인을 대체합니다. 이렇게 하면 AGP와의 통합이 간소화되고 지원 중단된 API를 사용하지 않으며 경우에 따라 성능이 향상됩니다.

Android Gradle 플러그인 9에는 Kotlin Gradle 플러그인 2.2.0에 대한 런타임 종속 항목이 있습니다. 이는 내장 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 {
    shaders = true
  }
}

삭제된 기능

Android Gradle 플러그인 9.0에서는 다음 기능을 삭제합니다.

• 삽입된 Wear OS 앱 지원
  AGP 9.0에서는 Play에서 더 이상 지원되지 않는 Wear OS 앱 삽입 지원이 삭제됩니다. 여기에는 wearApp 구성과 AndroidSourceSet.wearAppConfigurationName DSL이 삭제됩니다. Wear OS에 앱을 게시하는 방법은 Wear OS에 배포를 참고하세요.
• androidDependencies 및 sourceSets 보고 작업

DSL 변경

Android Gradle 플러그인 9.0에는 다음과 같은 주요 DSL 변경사항이 있습니다.

• CommonExtension의 매개변수화가 삭제되었습니다.

  이는 향후 소스 수준의 호환성 문제 방지를 위한 소스 수준의 호환성 문제일 뿐이지만 블록 메서드를 CommonExtension에서 ApplicationExtension, LibraryExension, 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은 작동하지 않았기 때문입니다.

• ComponentBuilder.enabled. ComponentBuilder.enable로 대체되었습니다.

• DependencyVariantSelection. DependencySelection로 대체되며, kotlin.android로 노출됩니다.

• Installation.installOptions(String). Installation.installOptions의 변경 가능한 속성으로 대체됩니다.

• VariantBuilder.targetSdk 및 targetSdkPreview는 라이브러리에서 의미가 없으므로 삭제했습니다. 대신 GeneratesApkBuilder.targetSdk 또는 GeneratesApkBuilder.targetSdkPreview을 사용하세요.

• 실험적이지만 안정화되지 않은 PostProcessing 블록입니다.

• ProductFlavor.setDimension: dimension 속성으로 대체됨

• LanguageSplitOptions는 지원 중단된 Google Play 인스턴트에만 유용했습니다.

• com.android.test 플러그인에는 적용되지 않았기 때문입니다.Variant.unitTest unitTest은 HasUnitTest을 확장하는 VariantBuilder 하위 유형에서 사용할 수 있습니다.

• com.android.test 플러그인에는 적용되지 않았기 때문입니다.VariantBuilder.enableUnitTest enableUnitTest은 HasUnitTestBuilder을 확장하는 VariantBuilder 하위 유형에서 사용할 수 있습니다.

• HasUnitTestBuilder을 확장하는 VariantBuilder 하위 유형에서 더 일관된 이름의 enableUnitTest을 사용하는 대신 VariantBuilder.unitTestEnabled이 삭제됩니다.

Gradle 속성 삭제

다음 Gradle 속성은 기본적으로 사용 설정된 기능을 전역적으로 사용 중지하는 방법으로 처음 추가되었습니다.

이러한 기능은 AGP 8.0 이하에서 기본적으로 사용 중지되었습니다. 더 효율적인 빌드를 위해 이러한 기능을 사용하는 하위 프로젝트에서만 사용 설정하세요.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

삭제된 API

Android Gradle 플러그인 9.0에서 다음이 삭제됩니다.

• 지원 중단되고 사용 중지된 BaseExtension.registerTransform API. AGP 4.2 이하에서 실행을 타겟팅하는 동안 최신 AGP 버전을 기준으로 컴파일할 수 있도록만 유지되었습니다.

강제 적용된 Gradle 속성

다음 Gradle 속성을 설정하면 AGP 9.0에서 오류가 발생합니다.

Android Gradle 플러그인 업그레이드 어시스턴트는 이러한 속성을 사용하는 프로젝트를 AGP 9.0으로 업그레이드하지 않습니다.