DocumentsUI

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

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

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

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

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

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

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

ב-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.