Tạo phiên bản API

Kể từ Android 11 (API cấp 30), các thiết bị Android sẽ bao gồm một bộ Tiện ích SDK. Khi được thêm vào, các API này sẽ thuộc một cấp độ API nhưng cũng có thể nằm trong một tiện ích SDK của một phiên bản cụ thể. Ví dụ: ACTION_PICK_IMAGES API cho Công cụ chọn ảnh được thêm vào SDK công khai trong Android 13 (API cấp 33), nhưng cũng có trong các tiện ích SDK kể từ các tiện ích R Phiên bản 2. Tên tiện ích SDK tương ứng với một hằng số nguyên. Hằng số đó có thể nằm trong Build.VERSION_CODES hoặc được xác định trong lớp SdkExtensions (chẳng hạn như SdkExtensions.AD_SERVICES).

Xác định Tiện ích SDK cần dùng

Để có thể sử dụng API Tiện ích SDK (SDK Extension API), trước tiên, bạn cần xác định SDK nào chứa API hỗ trợ các trường hợp sử dụng cho ứng dụng của mình.Các trang tài liệu tham khảo API cho API Tiện ích SDK cho biết phiên bản tiện ích SDK cũ nhất mà ứ...

Kiểm tra xem có Tiện ích SDK hay không

Ứng dụng của bạn có thể kiểm tra xem có những phiên bản Tiện ích SDK nào trong thời gian chạy. Đồng thời, trong quá trình phát triển, bạn có thể tìm các phiên bản tiện ích bằng lệnh Cầu gỡ lỗi Android (adb), như mô tả trong các phần sau.

Kiểm tra trong thời gian chạy

Trong thời gian chạy, ứng dụng của bạn có thể kiểm tra xem có Tiện ích SDK trong một phiên bản nền tảng cụ thể hay không bằng phương thức getExtensionVersion(). Ví dụ: Mã sau đây sẽ kiểm tra xem có phiên bản tiện ích 2 trở lên cho Tiện ích SDK Android 11...

Tiện ích Dịch vụ quảng cáo

Tương tự như tập hợp chung của Tiện ích SDK, tài liệu tham khảo API AdServices đôi khi cho biết API là một phần của phiên bản "Tiện ích Dịch vụ quảng cáo". Không giống như Tiện ích SDK chung, Tiện ích Dịch vụ quảng cáo sử dụng hằng số SdkExtensions.AD_SERVICES để xác định phiên bản có trên thiết bị:Để tìm hiểu thêm về các tính năng trong Tiện ích Dịch vụ quảng cáo và cách bắt đầu, hãy xem Tài liệu về Tiện ích Dịch vụ quảng cáo.

Phương thức tiện ích

Trong một số trường hợp, Tiện ích SDK có các phương thức tiện ích Jetpack để kiểm tra tính sẵn có của API Tiện ích SDK. Ví dụ: bạn có thể sử dụng hàm thư viện Jetpack để kiểm tra tính sẵn có của PhotoPicker, phương thức này sẽ loại bỏ các hoạt động kiểm tra có điều kiện đối với phiên bản.

Hỗ trợ về công cụ

Trong Android Studio Flamingo | 2022.2.1 trở lên, công cụ tìm lỗi mã nguồn có thể quét tìm vấn đề trong các phiên bản Tiện ích SDK khi kiểm tra NewAPI. Ngoài ra, Android Studio có thể tự động tạo chính xác hoạt động kiểm tra phiên bản cho các API được khởi chạy bằng Tiện ích SDK.

Tên và hằng số của Tiện ích SDK

Bảng sau đây mô tả cách các bộ Tiện ích SDK được liệt kê trong tài liệu tham khảo API ánh xạ đến các hằng số mà ứng dụng của bạn có thể dùng để kiểm tra tính sẵn có của API trong thời gian chạy. Bộ tiện ích SDK chung cho mỗi SDK công khai ánh xạ tới các giá trị của Build.VERSION_CODES.

Kiểm tra bằng adb

Để kiểm tra Tiện ích SDK nào có sẵn trên thiết bị bằng adb, hãy chạy lệnh sau:Sau khi chạy lệnh, bạn sẽ thấy kết quả có dạng sau:Mỗi dòng hiển thị một Tiện ích SDK có trên thiết bị cùng với phiên bản tiện ích tương ứng (phiên bản 3 trong trường hợp này).