واجهة المستخدم للمستندات

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

يؤدي جعل الوصول إلى مساحة التخزين والأذونات في وحدة ما إلى زيادة الخصوصية للمستخدمين النهائيين مع السماح لشركاء Android بتخصيص الميزات وتصميم التطبيق من خلال تراكبات موارد وقت التشغيل (RROs): يضمن تنسيق الوحدة أن يتم تستخدم هذه الأجهزة تجربة واجهة 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.