Trình bổ trợ Android cho Gradle 8.3.0 là một bản phát hành chính bao gồm nhiều tính năng và điểm cải thiện mới.
Khả năng tương thích
Cấp độ API tối đa mà trình bổ trợ Android cho Gradle 8.3 hỗ trợ là API cấp 34. Sau đây là một số 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 | 8.4 | 8.4 | Để tìm hiểu thêm, hãy xem phần cập nhật Gradle. |
| Công cụ tạo SDK | 34.0.0 | 34.0.0 | Cài đặt hoặc định cấu hình Công cụ tạo SDK. |
| NDK | Không áp dụng | 25.1.8937393 | 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. |
Sau đây là các tính năng mới trong trình bổ trợ Android cho Gradle 8.3.
Phát hành bản vá
Dưới đây là danh sách các bản vá đã phát hành trong Android Studio Iguana và trình bổ trợ Android cho Gradle 8.3.
Android Studio Iguana | 2023.2.1 Bản vá 2 và AGP 8.3.2 (tháng 4 năm 2024)
Bản cập nhật nhỏ này sửa các lỗi này.
Android Studio Iguana | 2023.2.1 Bản vá 1 và AGP 8.3.1 (tháng 3 năm 2024)
Bản cập nhật nhỏ này sửa các lỗi này.
Hỗ trợ Danh mục phiên bản Gradle
Android Studio hỗ trợ Danh mục phiên bản Gradle dựa trên TOML, một tính năng cho phép bạn quản lý các phần phụ thuộc ở một vị trí trung tâm và chia sẻ các phần phụ thuộc trên các mô-đun hoặc dự án. Android Studio hiện giúp bạn dễ dàng định cấu hình danh mục phiên bản thông qua các đề xuất của trình chỉnh sửa và tích hợp với hộp thoại Project Structure (Cấu trúc dự án). Tìm hiểu cách thiết lập và định cấu hình Danh mục phiên bản Gradle hoặc cách di chuyển bản dựng sang danh mục phiên bản.
Hoàn tất mã và điều hướng
Android Studio cung cấp tính năng hoàn thành mã khi bạn chỉnh sửa danh mục phiên bản ở định dạng tệp TOML hoặc thêm phần phụ thuộc từ danh mục phiên bản vào tệp bản dựng. Để sử dụng tính năng hoàn thành mã, hãy nhấn tổ hợp phím Ctrl+Space (Command+Space trên macOS). Ngoài ra, bạn có thể nhanh chóng chuyển từ tham chiếu phần phụ thuộc trong tệp build.gradle của ứng dụng đến vị trí phần phụ thuộc đó được khai báo trong danh mục phiên bản bằng cách nhấn tổ hợp phím Ctrl+b (Command+b trên macOS).
Tích hợp với hộp thoại Project Structure (Cấu trúc dự án)
Nếu dự án của bạn sử dụng danh mục phiên bản được xác định ở định dạng tệp TOML, bạn có thể chỉnh sửa các biến đã xác định ở đó thông qua chế độ xem Variables (Biến) trong hộp thoại Project Structure (Cấu trúc dự án) (File > Project Structure > Variables (Tệp > Cấu trúc dự án > Biến)) trong Android Studio. Đối với mỗi danh mục phiên bản, sẽ có một trình đơn thả xuống liệt kê các biến trong danh mục đó. Để chỉnh sửa một biến, hãy nhấp vào giá trị của biến đó rồi ghi đè biến đó. Khi bạn lưu các thay đổi này, tệp TOML sẽ được cập nhật tương ứng.
Bạn cũng có thể cập nhật các phần phụ thuộc trong chế độ xem Dependencies (Phần phụ thuộc) của hộp thoại Project Structure (Cấu trúc dự án) (File > Project Structure > Dependencies (Tệp > Cấu trúc dự án > Phần phụ thuộc)). Để cập nhật phiên bản bằng hộp thoại Project Structure (Cấu trúc dự án), hãy chuyển đến mô-đun và phần phụ thuộc mà bạn muốn chỉnh sửa, sau đó cập nhật trường Requested Version (Phiên bản đã yêu cầu). Khi bạn lưu các thay đổi này, tệp TOML sẽ được cập nhật cho phù hợp. Xin lưu ý rằng nếu phiên bản phần phụ thuộc được xác định bằng một biến, thì việc cập nhật phiên bản trực tiếp theo cách này sẽ thay thế biến đó bằng một giá trị được mã hoá cứng. Ngoài ra, hãy lưu ý rằng việc xoá một phần phụ thuộc khỏi tệp bản dựng, cho dù bạn có sử dụng hộp thoại Project Structure (Cấu trúc dự án) hay không, đều không xoá phần phụ thuộc đó khỏi danh mục phiên bản.
Các vấn đề và hạn chế đã biết
Sau đây là các vấn đề hoặc hạn chế đã biết về tính năng hỗ trợ Danh mục phiên bản Gradle trong Android Studio.
Lỗi làm nổi bật phần khai báo bí danh trình bổ trợ trong tệp tập lệnh Kotlin: khi bạn thêm phần khai báo trình bổ trợ ở dạng
alias(libs.plugins.example), trình chỉnh sửa sẽ thêm một đường gạch dưới màu đỏ bên dưới phầnlibs. Đây là vấn đề đã biết trong Gradle phiên bản 8.0 trở xuống và sẽ được giải quyết trong bản phát hành Gradle trong tương lai.Android Studio chỉ hỗ trợ danh mục phiên bản ở định dạng TOML: hiện tại, tính năng hỗ trợ hoàn thành mã, điều hướng và hộp thoại Cấu trúc dự án của Android Studio chỉ có sẵn cho các danh mục phiên bản được xác định ở định dạng tệp TOML. Tuy nhiên, bạn vẫn có thể thêm danh mục phiên bản ngay trong tệp
settings.gradlevà sử dụng các phần phụ thuộc của danh mục đó trong dự án.Không hỗ trợ điều hướng cho tệp bản dựng KTS: thao tác điều hướng đến định nghĩa phần phụ thuộc trong danh mục phiên bản bằng cách sử dụng tổ hợp phím Control+nhấp (Command+nhấp trên macOS) chưa được hỗ trợ cho các tệp bản dựng được viết bằng tập lệnh Kotlin.
Trợ lý Firebase thêm các phần phụ thuộc trực tiếp vào tập lệnh bản dựng: Trợ lý Firebase thêm các phần phụ thuộc trực tiếp vào tập lệnh bản dựng thay vì thông qua danh mục phiên bản.
Không hỗ trợ chức năng "Tìm cách sử dụng": chưa hỗ trợ việc tìm cách sử dụng biến danh mục phiên bản trong các tệp bản dựng khác, cho dù tệp bản dựng đó có ở KTS hay Groovy. Tức là việc sử dụng tổ hợp phím Control + nhấp chuột (Command + nhấp chuột trên macOS) trên định nghĩa biến trong danh mục phiên bản sẽ không dẫn đến các tệp bản dựng nơi biến được sử dụng.
Hộp thoại Cấu trúc dự án trong Android Studio hiển thị nhiều tệp danh mục nếu các tệp đó nằm trong thư mục
gradlegốc, nhưng không hiển thị danh mục cho bản dựng tổng hợp. Ví dụ: nếu bạn có hai tệp danh mục (một tệp cho ứng dụng và một tệp cho bản dựng tổng hợp), thì hộp thoại Cấu trúc dự án sẽ chỉ hiển thị tệp danh mục ứng dụng. Bạn có thể sử dụng bản dựng tổng hợp, nhưng phải trực tiếp chỉnh sửa tệp TOML của bản dựng đó.
Thông tin chi tiết khác về SDK: vấn đề về chính sách
Android Studio hiển thị các cảnh báo lỗi mã nguồn trong tệp build.gradle.kts và build.gradle cũng như trong Hộp thoại cấu trúc dự án cho những SDK công khai có lỗi vi phạm chính sách của Play trong Chỉ mục SDK của Google Play. Bạn nên cập nhật mọi phần phụ thuộc vi phạm chính sách của Play vì những lỗi vi phạm này có thể khiến bạn không thể phát hành ứng dụng lên Google Play Console trong tương lai. Cảnh báo vi phạm chính sách bổ sung cho cảnh báo phiên bản lỗi thời mà Android Studio hiển thị.
Hỗ trợ phiên bản compileSdk của Android Studio
Android Studio sẽ hiện cảnh báo nếu dự án của bạn sử dụng compileSdk không được phiên bản Android Studio hiện tại hỗ trợ. Nếu có, bạn cũng nên chuyển sang một phiên bản Android Studio hỗ trợ compileSdk mà dự án của bạn sử dụng. Xin lưu ý rằng việc nâng cấp Android Studio cũng có thể yêu cầu bạn nâng cấp AGP.
AGP cũng hiển thị cảnh báo trong cửa sổ công cụ Build (Bản dựng) nếu compileSdk mà dự án của bạn sử dụng không được phiên bản AGP hiện tại hỗ trợ.
Thay đổi về hành vi của trình tìm lỗi mã nguồn
Kể từ trình bổ trợ Android cho Gradle 8.3.0-alpha02, khi chạy công cụ tìm lỗi mã nguồn trên một mô-đun, các tác vụ phân tích tìm lỗi mã nguồn riêng biệt sẽ chạy cho các thành phần chính và thành phần kiểm thử của mô-đun. Lý do của thay đổi này là để cải thiện hiệu suất.
Để quay lại hành vi trước đó, hãy đặt android.experimental.lint.analysisPerComponent=false trong tệp gradle.properties.
Tính năng rút gọn tài nguyên chính xác được bật theo mặc định
Tính năng rút gọn tài nguyên chính xác (xoá các mục không dùng đến khỏi tệp resources.arsc và loại bỏ các tệp tài nguyên không dùng đến) được bật theo mặc định.
Khi tính năng rút gọn này được bật, bảng tài nguyên của bạn sẽ bị giảm và chỉ các mục nhập thư mục res được tham chiếu mới được đưa vào APK.
Để tắt tính năng rút gọn tài nguyên chính xác, hãy đặt android.enableNewResourceShrinker.preciseShrinking thành false trong tệp gradle.properties của dự án.
Vấn đề đã khắc phục
Trình bổ trợ Android cho Gradle 8.3.0
| Vấn đề đã khắc phục | ||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Trình bổ trợ Android cho Gradle |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
| Dexer (D8) |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
| Tìm lỗi mã nguồn |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
| Tích hợp công cụ tìm lỗi mã nguồn |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
| Trình rút gọn (R8) |
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Trình bổ trợ Android cho Gradle 8.3.1
| Vấn đề đã khắc phục | ||
|---|---|---|
| Trình bổ trợ Android cho Gradle |
|
|
| Tích hợp công cụ tìm lỗi mã nguồn |
|
|
Trình bổ trợ Android cho Gradle 8.3.2
| Vấn đề đã khắc phục | |||
|---|---|---|---|
| Trình bổ trợ Android cho Gradle |
|
||
| Tích hợp công cụ tìm lỗi mã nguồn |
|
||