يتحكّم وحدة DocumentsUI في الوصول إلى ملفات معيّنة للمكوّنات التي تتعامل مع أذونات المستندات (مثل إرفاق ملف برسالة إلكترونية). هذه الوحدة قابلة للتحديث، ما يعني أنّه يمكنها تلقّي تحديثات للوظائف خارج دورة إصدار Android العادية.
يؤدي تحويل أذونات الوصول إلى مساحة التخزين إلى وحدة إلى زيادة الخصوصية والأمان للمستخدمين النهائيين، مع السماح لشركاء Android بتخصيص ميزات التطبيق ومظهره من خلال تراكبات الموارد في وقت التشغيل (RRO). يضمن تنسيق الوحدة النمطية توفير تجربة DocumentsUI نفسها على جميع الأجهزة، ما يتيح للمطوّرين معرفة ما يراه المستخدمون لواجهات برمجة التطبيقات المرتبطة.
يتعامل وحدة DocumentsUI مع الإجراءات التالية.
التفاعل مع إطار العمل من خلال واجهات برمجة التطبيقات
@SystemApi
الثابتة فقط (بدون استخدام واجهات برمجة التطبيقات@hide
)تعرض هذه السمة آلية تتيح لشركاء Android تخصيص الميزات والمظاهر.
يحمي الإذن
MANAGE_DOCUMENTS
باستخدام إذن التوقيع.
رمز مشغّل "عرض الملفات"
في نظام التشغيل Android 10، تستخدم وحدة DocumentsUI السمة is_launcher_enabled
لتحديد ما إذا كان يجب عرض رمز مشغّل "الملفات" في درج التطبيقات. في نظام التشغيل Android 11 أو الإصدارات الأحدث، تستخدم الوحدة component-override
الحزمة لتحديد ما إذا كان سيتم عرض رمز مشغّل "الملفات" في درج التطبيقات.
يكون الرمز مفعَّلاً تلقائيًا. لإيقافها، أضِف كود XML التالي إلى
/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>
طلب بيانات المستخدم
ينفّذ وحدة DocumentsUI الإجراء GET_CONTENT
الذي يتيح للتطبيقات طلب الوصول إلى بيانات أخرى من المستخدم.
تنسيق الوحدة
يتم توفير وحدة DocumentsUI (com.android.documentsui
) كملف APK، وهي متاحة للأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android أو الإصدارات الأحدث.
المهام التابعة للوحدة
تعتمد وحدة DocumentsUI هذه على الإذن MANAGE_DOCUMENTS
المحمي
بإذن التوقيع، ويضمن فئة أذونات إضافية أنّه لا يملك الإذن MANAGE_DOCUMENTS
سوى تطبيق واحد على الجهاز.