מודול DocumentsUI שולט בגישה לקבצים ספציפיים לרכיבים שמטפלים בהרשאות של מסמכים (כמו צירוף קובץ לאימייל). המודול הזה ניתן לעדכון, כלומר הוא יכול לקבל עדכונים לפונקציונליות שלו מחוץ למחזור הרגיל של גרסאות Android.
הפיכת הגישה לאחסון וההרשאות למודול משפרת את הפרטיות והאבטחה של משתמשי הקצה, ומאפשרת לשותפי Android להתאים אישית את התכונות והעיצוב של האפליקציה באמצעות שכבות-על של משאבים בזמן ריצה (RRO). פורמט המודול מבטיח שכל המכשירים יישלחו עם אותה חוויית משתמש ב-DocumentsUI, וכך המפתחים יכולים לדעת מה המשתמשים רואים בממשקי API משויכים.
מודול DocumentsUI מטפל בפעולות הבאות.
האינטראקציה עם המסגרת מתבצעת רק באמצעות ממשקי API יציבים של
@SystemApi(ללא שימוש ב-@hideAPI).היא חושפת מנגנון שמאפשר לשותפי Android להתאים אישית תכונות וערכות נושא.
ההרשאה
MANAGE_DOCUMENTSמוגנת באמצעות הרשאת חתימה.
הצגת הסמל של Files במפעיל
ב-Android 10, מודול DocumentsUI משתמש ב-is_launcher_enabled כדי לקבוע אם סמל מפעיל הקבצים צריך להופיע במגירת האפליקציות. ב-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.