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

Trình bổ trợ Android cho Gradle 9.1 là một bản phát hành nhỏ bao gồm nhiều tính năng và điểm cải tiến mới.

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

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

Phiên bản tối thiểu Phiên bản mặc định Lưu ý
Gradle 9.3.1 9.3.1 Để tìm hiểu thêm, hãy xem phần cập nhật Gradle.
Công cụ tạo SDK 36.0.0 36.0.0 Cài đặt hoặc định cấu hình Công cụ tạo SDK.
NDK Không áp dụng 28.2.13676358 Cài đặt hoặc định cấu hình phiên bản khác của NDK.
JDK 17 17 Để tìm hiểu thêm, hãy xem phần cài đặt phiên bản JDK.

Thay đổi trong R8

Các thay đổi sau đây trong R8 được đưa vào AGP 9.1.0.

Bật tính năng đóng gói lại thành gói không tên (mặc định) khi biên dịch thành DEX

Theo mặc định, R8 sẽ đóng gói lại các lớp thành gói không tên (mặc định) khi biên dịch thành DEX. Điều này sẽ thêm quy tắc -repackageclasses vào các bản dựng không sử dụng -flattenpackagehierarchy hoặc -repackageclasses một cách rõ ràng.

Tính năng đóng gói lại theo mặc định đảm bảo tính nhất quán với tính năng làm rối mã nguồn, tối ưu hoá và thu gọn. Tất cả các tính năng này đều là tính năng chọn không tham gia thay vì chọn tham gia. Do đó, tính năng này sẽ giảm thiểu các cấu hình không tối ưu mà không chọn tham gia một cách rõ ràng để đóng gói lại.

Để chọn không tham gia hành vi này, hãy sử dụng quy tắc -dontrepackage mới.

Hỗ trợ các cấp độ có tên cho -maximumremovedandroidloglevel

Khi sử dụng -maximumremovedandroidloglevel, giờ đây, bạn có thể chỉ định tên cấp độ nhật ký thay vì các số. Bảng sau đây cho biết tên và cấp độ nhật ký số tương ứng.

Tên Cấp độ
ASSERT 7
ERROR 6
WARN 5
INFO 4
DEBUG 3
VERBOSE 2
NONE 1

Bạn phải chỉ định tên cấp độ nhật ký bằng chữ in hoa.

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

Trình bổ trợ Android cho Gradle 9.1.0-rc01

Vấn đề đã khắc phục
Không có vấn đề công khai nào được đánh dấu là đã khắc phục trong AGP 9.1.0-rc01

Trình bổ trợ Android cho Gradle 9.1.0-alpha09

Vấn đề đã khắc phục
Tìm lỗi mã nguồn
Công cụ tìm lỗi mã nguồn trong Otter.2 không nhận ra DSL compileSdk và targetSdk mới từ AGP 9.0

Trình bổ trợ Android cho Gradle 9.1.0-alpha08

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
Trình đơn Clean Project (Dọn sạch dự án) chạy mục tiêu dự án con thay vì chỉ "clean" (dọn sạch)
Lỗi đơn giản hoá dex tăng dần trong AGP
Bộ nhớ đệm cấu hình: tránh truy cập vào các tiện ích và quy ước của tác vụ tại thời gian thực thi
AGP không biết về các nền tảng canary và báo lỗi
Tích hợp công cụ tìm lỗi mã nguồn
Android Lint sử dụng K1 khi áp dụng cho dự án java-library
"Hoạt động kiểm tra tìm lỗi mã nguồn để tìm lỗi mã nguồn" hiện không chạy

Trình bổ trợ Android cho Gradle 9.1.0-alpha07

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
Cần triển khai beforeVariants cho KMP.

Trình bổ trợ Android cho Gradle 9.1.0-alpha06

Vấn đề đã khắc phục
Không có vấn đề công khai nào được đánh dấu là đã khắc phục trong AGP 9.1.0-alpha06

Trình bổ trợ Android cho Gradle 9.1.0-alpha05

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
AGP 9.0.0-rc01 không phân giải các thư viện Kotlin thông qua hàm kotlin()

Trình bổ trợ Android cho Gradle 9.1.0-alpha04

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
Các tệp `*.xml.flat` chứa đường dẫn tệp tuyệt đối

Trình bổ trợ Android cho Gradle 9.1.0-alpha03

Vấn đề đã khắc phục
Không có vấn đề công khai nào được đánh dấu là đã khắc phục trong AGP 9.1.0-alpha03

Trình bổ trợ Android cho Gradle 9.1.0-alpha02

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
Thêm khả năng chuyển cảnh báo ManifestProcessorTask thành lỗi

Trình bổ trợ Android cho Gradle 9.1.0-alpha01

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
Thêm khả năng chuyển cảnh báo ManifestProcessorTask thành lỗi
Việc chuyển đổi cấu phần phần mềm <code>OBFUSCATION_MAPPING_FILE</code> sẽ dẫn đến việc thiếu các đầu ra của tác vụ R8 trong thư mục đầu ra

Trình bổ trợ Android cho Gradle 9.1.0

Vấn đề đã khắc phục
Không có vấn đề công khai nào được đánh dấu là đã khắc phục trong AGP 9.1.0