DocumentsUI

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

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

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

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

  • يوفّر آلية تتيح لشركاء Android تخصيص الميزات و المظاهر.

  • حماية إذن MANAGE_DOCUMENTS باستخدام إذن التوقيع

رمز مشغّل "عرض الملفات"

في Android 10، تستخدِم وحدة DocumentsUI is_launcher_enabled لتحديد ما إذا كان ينبغي عرض رمز مشغّل تطبيق "الملفات" في درج التطبيقات. في الإصدار 11 من نظام التشغيل Android أو الإصدارات الأحدث، تستخدِم الوحدة حزمة component-override لتحديد ما إذا كان سيتم عرض رمز مشغّل "ملفات Google" في درج التطبيقات.

يكون الرمز مفعَّلاً تلقائيًا. لإيقاف هذه الميزة، أضِف ملف 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.