DocumentsUI

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

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

ماژول DocumentsUI اقدامات زیر را مدیریت می‌کند.

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

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

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

نمایش آیکون لانچر فایل‌ها

در اندروید ۱۰، ماژول DocumentsUI از is_launcher_enabled برای تعیین اینکه آیا آیکون لانچر Files باید در کشوی برنامه نمایش داده شود یا خیر، استفاده می‌کند. در اندروید ۱۱ یا بالاتر، این ماژول از پکیج component-override برای تعیین اینکه آیا آیکون لانچر Files در کشوی برنامه نمایش داده شود یا خیر، استفاده می‌کند.

به طور پیش‌فرض، این آیکون فعال است. برای غیرفعال کردن آن، 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 ارائه می‌شود و برای دستگاه‌هایی که اندروید ۱۰ یا بالاتر دارند، در دسترس است.

وابستگی‌های ماژول

این ماژول DocumentsUI به مجوز MANAGE_DOCUMENTS که توسط مجوز امضا محافظت می‌شود، وابسته است؛ یک کلاس مجوز اضافی تضمین می‌کند که فقط یک برنامه روی دستگاه دارای مجوز MANAGE_DOCUMENTS باشد.