المستندات

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