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

تتحكم وحدة 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 وهو متاح للأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android أو إصدار أحدث.

تبعيات الوحدة

تعتمد وحدة DocumentsUI هذه على إذن MANAGE_DOCUMENTS المحمي بإذن التوقيع، وتؤكّد فئة إذن إضافية أنّه ليس سوى تطبيق واحد على الجهاز لديه إذن MANAGE_DOCUMENTS.