DocumentsUI

واحد DocumentsUI دسترسی به فایل‌های خاص را برای مؤلفه‌هایی که اجازه‌های سند را مدیریت می‌کنند (مثل پیوست کردن فایل به ایمیل) کنترل می‌کند. این ماژول قابل‌به‌روزرسانی است، یعنی می‌تواند به‌روزرسانی‌های عملکرد را خارج از چرخه انتشار عادی Android دریافت کند.

تبدیل دسترسی به فضای ذخیره‌سازی و اجازه‌ها به واحد باعث افزایش حریم خصوصی و امنیت کاربران نهایی می‌شود و درعین‌حال به شرکای Android امکان می‌دهد ویژگی‌ها و زمینه‌های برنامه را ازطریق رونهادهای منبع زمان اجرا (RRO) سفارشی‌سازی کنند. قالب ماژول تضمین می‌کند که همه دستگاه‌ها با همان تجربه DocumentsUI عرضه شوند، و به توسعه‌دهندگان امکان می‌دهد بدانند کاربران برای میاناهای برنامه‌سازی کاربردی مرتبط چه چیزی می‌بینند.

واحد DocumentsUI کنش‌های زیر را مدیریت می‌کند.

  • فقط ازطریق @SystemApi میاناهای برنامه‌سازی کاربردی@hide پایدار با چارچوب تعامل دارد (از میاناهای برنامه‌سازی کاربردی استفاده نمی‌کند).

  • سازوکاری را برای فعال کردن شرکای Android برای سفارشی‌سازی ویژگی‌ها و زمینه ارائه می‌دهد.

  • از اجازه MANAGE_DOCUMENTS بااستفاده از اجازه امضا محافظت می‌کند.

نمایش نماد راه‌انداز «فایل‌ها»

در Android 10، واحد DocumentsUI از is_launcher_enabled برای تعیین اینکه آیا نماد راه‌انداز Files باید در کشوی برنامه نمایش داده شود یا نه استفاده می‌کند. در Android نسخه ۱۱ یا بالاتر، واحد از 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 را دارد.