ממשק המשתמש של מסמכים

המודול DocumentsUI שולט בגישה לקבצים ספציפיים עבור רכיבים תטפל בהרשאות המסמך (למשל, צירוף קובץ לאימייל). המודול הזה ניתן לעדכון, כלומר לקבל עדכונים של פונקציונליות מחוץ מחזור הפצה רגיל של Android.

הפיכת הגישה לאחסון והרשאות האחסון למודול משפרת את הפרטיות והאבטחה של משתמשי הקצה, ומאפשרת לשותפי Android להתאים אישית את התכונות והעיצוב של האפליקציה באמצעות שכבות-על של משאבים בסביבת זמן הריצה (RRO). פורמט המודול מבטיח המכשירים נשלחים באותה חוויית DocumentsUI, וכך מפתחים יכולים לדעת את מה שהמשתמשים רואים בממשקי ה-API המשויכים.

המודול DocumentsUI מטפל בפעולות הבאות.

  • האינטראקציה עם המסגרת מתבצעת רק דרך ממשקי API יציבים של @SystemApi (אין שימוש ב-API של @hide).

  • חושפת מנגנון שמאפשר לשותפי Android להתאים אישית תכונות לפי נושאים.

  • הגנה על ההרשאה MANAGE_DOCUMENTS באמצעות הרשאת חתימה.

הצגת סמל מרכז האפליקציות של Files

ב-Android 10, המודול DocumentsUI משתמש ב-is_launcher_enabled כדי לקבוע אם הסמל של מרכז האפליקציות של Files אמור להופיע בחלונית ההזזה לאפליקציות. ב-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.