المستندات

تتحكم وحدة DocumentsUI في الوصول إلى ملفات محددة للمكونات التي تتعامل مع أذونات المستند (مثل إرفاق ملف برسالة بريد إلكتروني). هذه الوحدة قابلة للتحديث، مما يعني أنها يمكن أن تتلقى تحديثات للوظائف خارج دورة إصدار Android العادية.

يؤدي جعل الوصول إلى التخزين والأذونات في وحدة نمطية إلى زيادة الخصوصية والأمان للمستخدمين النهائيين مع السماح لشركاء Android بتخصيص ميزات التطبيق وموضوعه من خلال تراكبات موارد وقت التشغيل (RROs) . يضمن تنسيق الوحدة أن جميع الأجهزة تأتي بنفس تجربة DocumentsUI، مما يتيح للمطورين معرفة ما يراه المستخدمون لواجهات برمجة التطبيقات المرتبطة.

تتعامل وحدة DocumentsUI مع الإجراءات التالية.

  • يتفاعل مع إطار العمل فقط من خلال واجهات برمجة التطبيقات @SystemApi الثابتة (لا يوجد استخدام @hide API).

  • يكشف عن آلية لتمكين شركاء 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 .