Mô-đun DocumentsUI kiểm soát quyền truy cập vào các tệp cụ thể của các thành phần xử lý các quyền đối với tài liệu (chẳng hạn như đính kèm tệp vào email). Mô-đun này có thể cập nhật, nghĩa là có thể nhận các bản cập nhật về chức năng bên ngoài chu kỳ phát hành Android thông thường.
Việc đưa các quyền và quyền truy cập vào bộ nhớ thành một mô-đun giúp tăng cường quyền riêng tư và bảo mật cho người dùng cuối, đồng thời cho phép các đối tác Android tuỳ chỉnh các tính năng và thay đổi giao diện của ứng dụng thông qua lớp phủ tài nguyên trong thời gian chạy (RRO). Định dạng mô-đun đảm bảo rằng tất cả các thiết bị nào cũng có cùng trải nghiệm DocumentsUI, giúp nhà phát triển biết được những gì người dùng nhìn thấy đối với các API được liên kết.
Mô-đun DocumentsUI xử lý các thao tác sau.
Chỉ tương tác với khung thông qua các API
@SystemApi
ổn định (không sử dụng API@hide
).Giới thiệu cơ chế cho phép đối tác Android tuỳ chỉnh các tính năng và tuỳ chỉnh giao diện.
Bảo vệ quyền
MANAGE_DOCUMENTS
bằng cách sử dụng quyền chữ ký.
Hiển thị biểu tượng trình chạy Tệp
Trong Android 10, mô-đun DocumentsUI sử dụng is_launcher_enabled
để xác định xem
biểu tượng trình chạy Files sẽ hiển thị trong ngăn ứng dụng. Trong Android 11 trở lên, mô-đun này sử dụng gói component-override
để xác định xem biểu tượng trình chạy Tệp có xuất hiện trong ngăn ứng dụng hay không.
Biểu tượng này được bật theo mặc định. Để tắt tính năng này, hãy thêm tệp XML sau vào /etc/sysconfig
.
<?xml version="1.0" encoding="utf-8"?>
<config>
<component-override package="com.android.documentsui" >
<component class="com.android.documentsui.LauncherActivity" enabled="false" />
</component-override>
</config>
Yêu cầu dữ liệu người dùng
Mô-đun DocumentsUI triển khai thao tác GET_CONTENT
cho phép ứng dụng yêu cầu người dùng cấp quyền truy cập vào dữ liệu khác.
Định dạng mô-đun
Mô-đun DocumentsUI (com.android.documentsui
) được phân phối dưới dạng một
Tệp APK và khả dụng cho các thiết bị chạy Android
10 trở lên.
Phần phụ thuộc của mô-đun
Mô-đun DocumentsUI này phụ thuộc vào quyền MANAGE_DOCUMENTS
được bảo vệ
bằng quyền chữ ký; một lớp quyền bổ sung đảm bảo rằng chỉ
một ứng dụng trên thiết bị có quyền MANAGE_DOCUMENTS
.