تتحكم وحدة DocumentsUI في الوصول إلى ملفات محددة للمكونات التي التعامل مع أذونات المستند (مثل إرفاق ملف برسالة إلكترونية). يمكن تعديل هذه الوحدة، ما يعني أنّه يمكنها تلقّي تحديثات للوظائف خارج دورة الإصدار العادية لنظام Android.
يؤدي تحويل أذونات الوصول إلى مساحة التخزين إلى وحدة إلى تعزيز الخصوصية والأمان للمستخدمين النهائيين، مع السماح لشركاء Android بتخصيص ميزات وموضوعات التطبيق من خلال عمليات تراكب موارد وقت التشغيل (RRO). يضمن تنسيق الوحدة أن يتم شحن كل الأجهزة مع تجربة DocumentsUI نفسها، ما يتيح للمطوّرين معرفة ما يظهر للمستخدمين في واجهات برمجة التطبيقات المرتبطة.
تعالج وحدة DocumentsUI الإجراءات التالية.
لا تتفاعل مع الإطار إلا من خلال واجهات برمجة تطبيقات
@SystemApiالثابتة (لا يتم استخدام@hideAPI).تعرِض آلية لتفعيل شركاء 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.