تتحكم وحدة 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.