Trình bổ trợ Android cho Gradle 9.0.1 (tháng 1 năm 2026)

Trình bổ trợ Android cho Gradle 9.0 là một bản phát hành lớn, mang đến những thay đổi về API và hành vi.

Để cập nhật lên trình bổ trợ Android cho Gradle phiên bản 9.0.1, hãy sử dụng Trợ lý nâng cấp trình bổ trợ Android cho Gradle. Trợ lý nâng cấp AGP giúp duy trì các hành vi hiện có khi nâng cấp dự án bất cứ khi nào phù hợp, nhờ đó, bạn có thể nâng cấp dự án để sử dụng AGP 9.0 ngay cả khi chưa sẵn sàng áp dụng tất cả các giá trị mặc định mới trong AGP 9.0.

Ngoài ra, còn có hai kỹ năng của nhân viên hỗ trợ giúp quá trình nâng cấp trở nên dễ dàng hơn. Đối với ứng dụng không phải KMP, hãy thử kỹ năng nâng cấp AGP 9 trong kho lưu trữ kỹ năng Android. Đối với ứng dụng KMP, hãy thử kỹ năng nâng cấp AGP 9 của JetBrains. Để biết thêm thông tin về cách sử dụng kỹ năng trong Android Studio, hãy xem bài viết Mở rộng Chế độ tác nhân bằng kỹ năng.

Khả năng tương thích

Cấp độ API tối đa mà Trình bổ trợ Android cho Gradle 9.0 hỗ trợ là cấp độ API 36.1. Sau đây là thông tin khác về khả năng tương thích:

Các lớp DSL android hiện chỉ triển khai các giao diện công khai mới

Trong vài năm qua, chúng tôi đã ra mắt các giao diện mới cho DSL và API để kiểm soát tốt hơn những API nào là công khai. Các phiên bản AGP 7.x và 8.x vẫn sử dụng các loại DSL cũ (ví dụ: BaseExtension) cũng triển khai các giao diện công khai mới, nhằm duy trì khả năng tương thích khi công việc tiến triển trên các giao diện.

AGP 9.0 chỉ sử dụng các giao diện DSL mới của chúng tôi, và các cách triển khai đã thay đổi thành các loại mới hoàn toàn bị ẩn. Việc này cũng xoá quyền truy cập vào API biến thể cũ, không dùng nữa.

Để cập nhật lên AGP 9.0, bạn có thể cần làm như sau:

• Đảm bảo dự án của bạn tương thích với Kotlin tích hợp sẵn: Trình bổ trợ org.jetbrains.kotlin.android không tương thích với DSL mới.

• Chuyển dự án KMP sang Trình bổ trợ thư viện Android cho Gradle dành cho KMP: Việc sử dụng trình bổ trợ org.jetbrains.kotlin.multiplatform trong cùng một dự án con Gradle với trình bổ trợ com.android.library và com.android.application không tương thích với DSL mới.

• Cập nhật tệp bản dựng: Mặc dù việc thay đổi giao diện nhằm giữ cho DSL giống nhau nhất có thể, nhưng có thể có một số thay đổi nhỏ.

• Cập nhật logic bản dựng tuỳ chỉnh để tham chiếu đến DSL và API mới: Thay thế mọi tệp đối chiếu đến DSL nội bộ bằng giao diện DSL công khai. Trong hầu hết các trường hợp, đây sẽ là sự thay thế một-một. Thay thế mọi trường hợp sử dụng applicationVariants và các API tương tự bằng androidComponents API mới. Việc này có thể phức tạp hơn vì API androidComponents được thiết kế để ổn định hơn nhằm giúp các trình bổ trợ tương thích lâu hơn. Hãy xem Công thức Gradle để biết ví dụ.

• Cập nhật trình bổ trợ của bên thứ ba: Một số trình bổ trợ của bên thứ ba có thể vẫn phụ thuộc vào các giao diện hoặc API không còn được hiển thị. Di chuyển sang các phiên bản trình bổ trợ tương thích với AGP 9.0.

Việc chuyển sang giao diện DSL mới giúp ngăn các trình bổ trợ và tập lệnh bản dựng Gradle sử dụng nhiều API không dùng nữa, bao gồm:

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

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

Nếu bạn cập nhật lên AGP 9.0 và thấy thông báo lỗi sau, thì tức là dự án của bạn vẫn đang tham chiếu đến một số loại cũ:

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

Nếu bị chặn bởi các trình bổ trợ không tương thích của bên thứ ba, bạn có thể chọn không sử dụng và quay lại các cách triển khai cũ cho DSL, cũng như API biến thể cũ. Trong khi thực hiện việc này, các giao diện mới cũng có sẵn và bạn vẫn có thể cập nhật logic bản dựng của riêng mình lên API mới. Để chọn không sử dụng, hãy thêm dòng này vào tệp gradle.properties:

android.newDsl=false

Ngoài ra, để di chuyển dần dần, AGP 9.4 cho phép bạn chọn không sử dụng từng mô-đun. Để tìm hiểu cách thực hiện, hãy xem phần Chọn không tham gia mô-đun Variant API.

Các lớp trước đó được đánh dấu là không dùng nữa trong AGP 9.0. Điều này có nghĩa là những dự án chọn không sử dụng cờ newDsl sẽ thấy cảnh báo ngừng hoạt động, bao gồm cả cảnh báo trên chính khối android.

Bạn cũng có thể bắt đầu nâng cấp lên các API mới trước khi nâng cấp lên AGP 9.0. Các giao diện mới đã có trong nhiều phiên bản AGP, vì vậy, bạn có thể kết hợp cả giao diện mới và cũ. Tài liệu tham khảo API AGP cho thấy giao diện API cho từng phiên bản AGP, cũng như thời điểm thêm từng lớp, phương thức và trường.

Chúng tôi đang liên hệ với tác giả của các trình bổ trợ thường dùng để giúp họ điều chỉnh và phát hành các trình bổ trợ hoàn toàn tương thích với các chế độ mới, đồng thời sẽ tiếp tục cải tiến Trợ lý nâng cấp AGP trong Android Studio để hướng dẫn bạn thực hiện quá trình di chuyển.

Nếu bạn nhận thấy DSL hoặc API biến thể mới thiếu các chức năng hoặc tính năng, vui lòng gửi vấn đề càng sớm càng tốt.

Kotlin tích hợp sẵn

Trình bổ trợ Android cho Gradle 9.0 ra mắt tính năng hỗ trợ Kotlin tích hợp sẵn và bật tính năng này theo mặc định. Điều này có nghĩa là bạn không cần phải áp dụng trình bổ trợ org.jetbrains.kotlin.android (hoặc kotlin-android) trong tệp bản dựng để biên dịch tệp nguồn Kotlin nữa. Việc này giúp đơn giản hoá quá trình tích hợp Kotlin với AGP, tránh sử dụng các API không dùng nữa và cải thiện hiệu suất trong một số trường hợp.

Do đó, khi nâng cấp dự án lên AGP 9.0, bạn cũng cần di chuyển sang Kotlin tích hợp sẵn hoặc chọn không sử dụng.

Bạn cũng có thể chọn tắt tính năng hỗ trợ Kotlin tích hợp sẵn cho các dự án con Gradle không có nguồn Kotlin.

Phần phụ thuộc thời gian chạy trên trình bổ trợ Kotlin cho Gradle

Để cung cấp tính năng hỗ trợ Kotlin tích hợp sẵn, Trình bổ trợ Android cho Gradle 9.0 hiện có một phần phụ thuộc thời gian chạy trên Trình bổ trợ Kotlin cho Gradle (KGP) 2.2.10. Điều này có nghĩa là bạn không còn phải khai báo phiên bản KGP nữa và nếu bạn sử dụng phiên bản KGP thấp hơn 2.2.10, Gradle sẽ tự động nâng cấp phiên bản KGP của bạn lên 2.2.10. Tương tự, nếu bạn sử dụng phiên bản KSP thấp hơn 2.2.10-2.0.2, thì AGP sẽ nâng cấp phiên bản đó lên 2.2.10-2.0.2 để khớp với phiên bản KGP.

Nâng cấp lên phiên bản KGP cao hơn

Để sử dụng phiên bản KGP hoặc KSP cao hơn, hãy thêm nội dung sau vào tệp bản dựng cấp cao nhất:

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")
    }
}

Hạ cấp xuống phiên bản KGP thấp hơn

Bạn chỉ có thể hạ cấp phiên bản KGP nếu đã chọn không sử dụng Kotlin tích hợp sẵn. Điều này là do AGP 9.0 bật Kotlin tích hợp theo mặc định và Kotlin tích hợp yêu cầu KGP 2.2.10 trở lên.

Để sử dụng phiên bản KGP hoặc KSP thấp hơn, hãy khai báo phiên bản đó trong tệp bản dựng cấp cao nhất bằng cách sử dụng nội dung khai báo phiên bản nghiêm ngặt:

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") }
        }
    }
}

Xin lưu ý rằng phiên bản KGP tối thiểu mà bạn có thể hạ cấp là 2.0.0.

Hỗ trợ IDE cho môi trường thử nghiệm cố định

AGP 9.0 hỗ trợ đầy đủ IDE Android Studio cho môi trường thử nghiệm cố định.

Trình bổ trợ thư viện hợp nhất

Trình bổ trợ thư viện hợp nhất (Bản xem trước) cho phép bạn phát hành nhiều thư viện dưới dạng một tệp AAR thư viện Android duy nhất. Điều này có thể giúp người dùng dễ dàng dựa vào cấu phần phần mềm đã xuất bản của bạn.

Để biết thông tin về cách bắt đầu, hãy xem bài viết Phát hành nhiều thư viện Android dưới dạng một thư viện bằng Thư viện hợp nhất.

Thay đổi về hành vi

Trình bổ trợ Android cho Gradle 9.0 có các hành vi mới sau:

AGP 9.0 có các bản cập nhật cho chế độ mặc định của các thuộc tính Gradle sau đây. Điều này giúp bạn có thể chọn giữ nguyên hành vi AGP 8.13 khi nâng cấp:

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

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

Các tính năng đã bị xoá

Trình bổ trợ Android cho Gradle 9.0 sẽ xoá các chức năng sau:

• Hỗ trợ ứng dụng Wear OS được nhúng
  AGP 9.0 loại bỏ tính năng hỗ trợ nhúng ứng dụng Wear OS, vốn không còn được hỗ trợ trong Play. Việc này bao gồm cả việc xoá cấu hình wearApp và AndroidSourceSet.wearAppConfigurationName DSL. Hãy xem phần Phân phối cho Wear OS để biết cách phát hành ứng dụng cho Wear OS.
• androidDependencies và sourceSets báo cáo việc cần làm
• Hỗ trợ APK phân tách theo mật độ
  AGP 9.0 không còn hỗ trợ việc tạo APK phân tách dựa trên mật độ màn hình. Chức năng và các API liên quan đã bị xoá. Để phân tách APK phân tách dựa trên mật độ màn hình bằng AGP 9.0 trở lên, hãy sử dụng gói ứng dụng.

DSL đã thay đổi

Trình bổ trợ Android cho Gradle 9.0 có những thay đổi có thể gây lỗi sau đây về DSL:

• Tham số hoá của CommonExtension đã bị xoá.

  Bản thân thay đổi này chỉ là một thay đổi có thể gây lỗi ở cấp nguồn để giúp tránh các thay đổi có thể gây lỗi ở cấp nguồn trong tương lai, nhưng điều này cũng có nghĩa là các phương thức chặn cần chuyển từ CommonExtension sang ApplicationExtension, LibraryExtension, DynamicFeatureExtension và TestExtension.

  Khi nâng cấp dự án lên AGP 9.0, hãy tái cấu trúc mã trình bổ trợ Gradle sử dụng các tham số đó hoặc các phương thức khối. Ví dụ: trình bổ trợ sau đây được cập nhật để xoá tham số loại và không dựa vào các phương thức khối đã bị xoá:

  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)
          }
      }
  }
  

  Đối với các trình bổ trợ nhắm đến một loạt phiên bản AGP, việc sử dụng trực tiếp phương thức getter sẽ tương thích nhị phân với các phiên bản AGP thấp hơn 9.0.

Đã xóa DSL

Trình bổ trợ Android cho Gradle 9.0 sẽ xoá:

• AndroidSourceSet.jni, vì không hoạt động.

• AndroidSourceSet.wearAppConfigurationName, vì liên quan đến việc ngừng hỗ trợ ứng dụng Wear OS được nhúng.

• BuildType.isRenderscriptDebuggable, vì không hoạt động.

• DependencyVariantSelection. Tính năng này được thay thế bằng DependencySelection, được hiển thị dưới dạng kotlin.android.localDependencySelection

• Installation.installOptions(String). Tính năng này được thay thế bằng thuộc tính có thể thay đổi của Installation.installOptions.

• Khối PostProcessing thử nghiệm nhưng chưa bao giờ ổn định.

• ProductFlavor.setDimension, được thay thế bằng thuộc tính dimension

• LanguageSplitOptions, chỉ hữu ích cho Google Play Instant, hiện không còn được dùng nữa.

• DensitySplit, vì tính năng này không còn được hỗ trợ. Thay vào đó, hãy sử dụng Gói ứng dụng.

API đã bị xoá

Trình bổ trợ Android cho Gradle 9.0 sẽ xoá:

• AndroidComponentsExtension.finalizeDSl. Tính năng này được thay thế bằng finalizeDsl

• Component.transformClassesWith. Tính năng này được thay thế bằng Instrumentation.transformClassesWith

• Component.setAsmFramesComputationMode. Tính năng này được thay thế bằng Instrumentation.setAsmFramesComputationMode

• ComponentBuilder.enabled. Tính năng này được thay thế bằng ComponentBuilder.enable.

• DependenciesInfoBuilder.includedInApk. Tính năng này được thay thế bằng includeInApk

• DependenciesInfoBuilder.includedInBundle. Tính năng này được thay thế bằng includeInBundle

• GeneratesApk.targetSdkVersion. Tính năng này được thay thế bằng targetSdk

• Variant.minSdkVersion. Tính năng này được thay thế bằng minSdk

• Variant.maxSdkVersion. Tính năng này được thay thế bằng maxSdk

• Variant.targetSdkVersion. Tính năng này được thay thế bằng targetSdk

• Variant.unitTest, vì không áp dụng cho trình bổ trợ com.android.test. unitTest có sẵn trên các loại phụ VariantBuilder mở rộng HasUnitTest.

• VariantBuilder.targetSdk và targetSdkPreview, vì chúng không có ý nghĩa trong thư viện. Thay vào đó, hãy sử dụng GeneratesApkBuilder.targetSdk hoặc GeneratesApkBuilder.targetSdkPreview.

• VariantBuilder.enableUnitTest, vì không áp dụng cho trình bổ trợ com.android.test. enableUnitTest có sẵn trên các loại phụ VariantBuilder mở rộng HasUnitTestBuilder.

• VariantBuilder.unitTestEnabled bị xoá để thay thế bằng enableUnitTest có tên nhất quán hơn trên các loại phụ VariantBuilder mở rộng HasUnitTestBuilder.

• VariantOutput.enable. Tính năng này được thay thế bằng enabled

• FeaturePlugin và FeatureExtension không còn được dùng nữa và đã bị vô hiệu hoá.

• Các API BaseExtension.registerTransform không dùng nữa và bị vô hiệu hoá, chỉ còn lại để cho phép biên dịch dựa trên phiên bản AGP mới nhất trong khi nhắm đến việc chạy trên AGP 4.2 trở xuống.

Các thuộc tính Gradle đã bị xoá

Ban đầu, các thuộc tính Gradle sau đây được thêm vào dưới dạng các cách để tắt trên toàn hệ thống các tính năng được bật theo mặc định.

Theo mặc định, các tính năng này đã bị tắt kể từ AGP 8.0 trở xuống. Chỉ bật các tính năng này trong những dự án con sử dụng chúng để tạo bản dựng hiệu quả hơn.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Thuộc tính Gradle bắt buộc

AGP 9.0 sẽ báo lỗi nếu bạn đặt các thuộc tính Gradle sau đây.

Trợ lý nâng cấp trình bổ trợ Android cho Gradle sẽ không nâng cấp các dự án sử dụng những thuộc tính này lên AGP 9.0.

Thay đổi về R8

AGP 9.0.0 có các thay đổi sau đây đối với R8.

Lựa chọn cấu hình mới -processkotlinnullchecks

Chúng tôi đã thêm tuỳ chọn R8 mới -processkotlinnullchecks để định cấu hình R8 cho việc xử lý các quy trình kiểm tra giá trị rỗng của Kotlin. Tuỳ chọn này nhận một đối số bắt buộc phải là một trong ba giá trị sau: keep, remove_message và remove. Tuỳ chọn này xử lý các quy trình kiểm tra rỗng sau đây do trình biên dịch Kotlin thêm vào:

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);
}

Các giá trị của tuỳ chọn, được sắp xếp từ yếu nhất đến mạnh nhất, có hiệu lực như sau:

• keep không thay đổi các bước kiểm tra.
• remove_message viết lại mỗi lệnh gọi phương thức kiểm tra thành một lệnh gọi đến getClass() trên đối số đầu tiên của lệnh gọi (giữ lại quy trình kiểm tra rỗng một cách hiệu quả nhưng không có thông báo nào).
• remove sẽ xoá hoàn toàn các bước kiểm tra.

Theo mặc định, R8 sử dụng remove_message. Mọi thông số kỹ thuật của -processkotlinnullchecks sẽ ghi đè thông số đó. Nếu bạn chỉ định nhiều lần, giá trị mạnh nhất sẽ được sử dụng.

Ngừng truyền thông tin giữ lại cho các phương thức đồng hành

Khi các quy tắc giữ lại khớp với các phương thức giao diện phải trải qua quá trình đơn giản hoá, R8 trước đây đã chuyển nội bộ các bit không cho phép tối ưu hoá và không cho phép thu hẹp sang các phương thức đồng hành được tổng hợp.

Kể từ AGP 9.0, các quy tắc giữ lại không còn áp dụng cho các phương thức đồng hành. Điều này phù hợp với thực tế là các quy tắc giữ lại không áp dụng cho các trường/phương thức/lớp khác do trình biên dịch tổng hợp.

Bằng cách chuyển các bit disallow optimization (không cho phép tối ưu hoá) và disallow shrinking (không cho phép rút gọn) sang các phương thức đồng hành, trường hợp sử dụng sau đây đã được hỗ trợ trước đó:

1. Biên dịch thư viện có các phương thức giao diện default/static/private thành DEX có minSdk < 24 và các quy tắc giữ lại các phương thức giao diện.
2. Biên dịch ứng dụng bằng thư viện trên classpath và -applymapping.
3. Hợp nhất ứng dụng và thư viện.

Xin lưu ý rằng việc này chỉ hoạt động với -applymapping vì bit disallow obfuscation không được chuyển sang các phương thức đồng hành, tức là các lớp đồng hành được tạo từ bước 1 sẽ có tên phương thức bị làm rối mã nguồn.

Trong tương lai, trường hợp sử dụng này sẽ không còn được hỗ trợ cho minSdk < 24. Cách giải quyết là làm như sau:

1. Khử糖 thư viện bằng các phương thức giao diện default/static/private cho các tệp lớp có minSdk < 24.
2. Biên dịch cấu phần phần mềm đã đơn giản hoá bằng R8 và các quy tắc giữ lại phương thức giao diện trên các lớp đồng hành.
3. Biên dịch ứng dụng bằng thư viện trên classpath.
4. Hợp nhất ứng dụng và cấu phần mềm đã đơn giản hoá cú pháp.

Một tác dụng phụ khác của việc này là không thể giữ lại các thuộc tính của lớp bên trong và phương thức bao quanh cho các lớp ẩn danh và cục bộ bên trong các phương thức đồng hành của giao diện.

Thay đổi tệp nguồn được phát ra mặc định thành r8-map-id-<MAP_ID>

Thay đổi này có trong AGP kể từ phiên bản 8.12.0.

Thuộc tính tệp nguồn được phát ra mặc định cho một lớp sẽ thay đổi từ SourceFile thành r8-map-id-<MAP_ID> khi cần truy xuất lại (tức là khi bật tính năng làm rối mã nguồn hoặc tối ưu hoá).

Khi có dấu vết ngăn xếp bị làm rối mã nguồn, thuộc tính tệp nguồn mới cho phép trích xuất mã nhận dạng của tệp ánh xạ cần thiết cho việc truy vết. Mã nhận dạng này có thể được dùng để hỗ trợ tự động truy vết dấu vết ngăn xếp trong Logcat.

Nếu bạn sử dụng thuộc tính tệp nguồn tuỳ chỉnh (-renamesourcefileattribute), thì thuộc tính tệp nguồn tuỳ chỉnh này sẽ tiếp tục được ưu tiên.

Ở chế độ tương thích với ProGuard (khi gradle.properties chứa android.enableR8.fullMode=false), việc phát ra thuộc tính tệp nguồn của r8-map-id-<MAP_ID> chỉ có hiệu lực nếu thuộc tính SourceFile không được giữ lại. Những ứng dụng sử dụng chế độ tương thích ProGuard và muốn đưa mã nhận dạng tệp ánh xạ vào dấu vết ngăn xếp nên xoá -keepattributes SourceFile (hoặc di chuyển sang chế độ đầy đủ R8).

Mã bản đồ được dùng trong r8-map-id-<MAP_ID> là hàm băm bản đồ đầy đủ, chứ không phải tiền tố gồm 7 ký tự của hàm băm bản đồ đã được dùng trước đó.

Cho phép sử dụng tên tổng hợp được thu nhỏ trong quá trình đơn giản hoá cú pháp L8

Tên của các lớp tổng hợp do D8 tạo thường chứa chuỗi con $$ExternalSynthetic cho biết đây là lớp tổng hợp do D8 tạo. Hơn nữa, tên của lớp tổng hợp cũng mã hoá loại lớp tổng hợp (ví dụ: Backport, Lambda). Điều này có tác động tiêu cực đến kích thước tệp DEX thu được, vì tên lớp chiếm nhiều không gian hơn trong vùng chứa chuỗi.

AGP 9.0 định cấu hình L8 (đơn giản hoá thư viện cốt lõi) để tệp DEX chứa tất cả các lớp j$ sử dụng định dạng tên lớp rút gọn mới cho các lớp tổng hợp. Tên lớp mới sử dụng mã nhận dạng dạng số (ví dụ: $1).

Xoá tính năng hỗ trợ dành cho -addconfigurationdebugging

AGP 9.0 ngừng hỗ trợ -addconfigurationdebugging. Trình biên dịch hiện báo cáo cảnh báo nếu cờ được sử dụng.

Xoá tính năng hỗ trợ tạo quy tắc L8 từ D8/R8

Thay đổi này chỉ liên quan đến những nhà phát triển trực tiếp sử dụng dòng lệnh hoặc API D8/R8.

R8 9.0 ngừng hỗ trợ việc tạo quy tắc giữ lại cho L8 từ D8 và R8. Thay vào đó, bạn nên sử dụng TraceReferences cho mục đích này.

Cụ thể hơn, các phương thức D8Command.builder.setDesugaredLibraryKeepRuleConsumer và R8Command.Builder.setDesugaredLibraryKeepRuleConsumer sẽ bị xoá, đồng thời khả năng hỗ trợ --desugared-lib-pg-conf-output cũng bị xoá khỏi các tuỳ chọn dòng lệnh của D8 và R8.

Vấn đề đã khắc phục

Trình bổ trợ Android cho Gradle 9.0.0