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

המודול 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 כדי לקבוע אם סמל מרכז האפליקציות של 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 וזמין למכשירים עם מערכת Android בגרסה 10 ומעלה.

יחסי תלות בין מודולים

המודול הזה של DocumentsUI תלוי בהרשאה MANAGE_DOCUMENTS שמוגנת על ידי הרשאת החתימה. סיווג הרשאה נוסף מבטיח שלאפליקציה אחת בלבד במכשיר תהיה ההרשאה MANAGE_DOCUMENTS.