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

Trình bổ trợ Android cho Gradle 9.4 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.4 hỗ trợ là cấp độ API 37. Sau đâ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.6.0 9.6.0 Để 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.

Chọn không tham gia mô-đun Variant API

Kể từ AGP 10, Variant API mới là bắt buộc đối với tất cả dự án. Để hỗ trợ quá trình di chuyển dần dần, bạn có thể tạm thời chọn không áp dụng yêu cầu này cho một số mô-đun cụ thể trước khi AGP 10 ra mắt bằng cách áp dụng đoạn mã sau vào tệp gradle.properties.

android.newDsl.optOut=:example-lib1

Sự tương đồng nghiêm ngặt giữa biến thể 1:1 giữa tính năng động và ứng dụng Android

Kể từ AGP 9.4, hệ thống xây dựng sẽ kiểm tra mức độ tương đương nghiêm ngặt 1:1 về phương diện phiên bản giữa các mô-đun ứng dụng Android và mô-đun tính năng động, đồng thời báo cáo mọi phương diện bị thiếu, thừa hoặc không khớp dưới dạng cảnh báo bản dựng. Để giúp bạn chuẩn bị cho quy trình xác thực nghiêm ngặt hơn mà không làm hỏng quy trình xây dựng hiện có, bước kiểm tra này hoạt động ở chế độ cảnh báo theo mặc định, nhưng có thể được nâng cấp thành lỗi thực thi bằng cách bật tuỳ chọn Gradle android.enforceDynamicFeatureVariantMatching=true. Kể từ AGP 10.0 trở đi, tính tương đương nghiêm ngặt 1:1 của biến thể sẽ được thực thi theo mặc định, biến tất cả các trường hợp không khớp về phương diện giữa ứng dụng cơ sở và mô-đun tính năng động thành lỗi bản dựng nghiêm trọng.

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

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

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.4.0-alpha04

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

Vấn đề đã khắc phục
Trình rút gọn (R8)
Không có tệp ánh xạ làm rối mã nguồn L8 trong tệp mapping.txt của ứng dụng

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

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
AGP SigningConfig quá háo hức
"Unable to get provider" (ClassNotFoundException) (Không thể lấy nhà cung cấp (ClassNotFoundException)) khi chạy `./gradlew :app:connectedDebugAndroidTest` với một nhà cung cấp được xác định trong mô-đun tính năng động

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

Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle
AGP SigningConfig quá háo hức