تتحكّم وحدة 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 وهي متاحة للأجهزة التي تعمل بنظام التشغيل Android 10 أو الإصدارات الأحدث.
المهام التابعة للوحدة
تعتمد وحدة DocumentsUI هذه على الإذن MANAGE_DOCUMENTS المحمي بإذن التوقيع، ويضمن فئة أذونات إضافية أنّ تطبيقًا واحدًا فقط على الجهاز لديه الإذن MANAGE_DOCUMENTS.