קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
המודול 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.
המודול DocumentsUI מטמיע את הפעולה GET_CONTENT שמאפשרת לאפליקציות לבקש מהמשתמשים גישה לנתונים אחרים.
פורמט המודול
המודול DocumentsUI (com.android.documentsui) מועבר כקובץ APK והוא זמין במכשירים עם Android מגרסה 10 ואילך.
יחסי תלות בין מודולים
המודול DocumentsUI הזה תלוי בהרשאה MANAGE_DOCUMENTS שמוגנת על ידי הרשאת החתימה. סיווג הרשאה נוסף מבטיח שלאפליקציה אחת בלבד במכשיר תהיה ההרשאה MANAGE_DOCUMENTS.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# DocumentsUI\n\n| **Important:** Starting in Android 12, file browsing through DocumentsUI is disabled.\n\nThe DocumentsUI module controls access to specific files for components that\nhandle document permissions (such as attaching a file to an email). This module\nis updatable, meaning it can receive updates to functionality outside of the\nnormal Android release cycle.\n\nMaking storage access and permissions into a module increases privacy and\nsecurity for end users while allowing Android partners to customize the features\nand theming of the app through [runtime resource overlays\n(RROs)](/docs/core/architecture/rros). The module format ensures that all\ndevices ship with the same DocumentsUI experience, enabling developers to know\nwhat users see for associated APIs.\n\nThe DocumentsUI module handles the following actions.\n\n- Interacts with the framework only through stable `@SystemApi` APIs (no\n `@hide` API usage).\n\n- Exposes a mechanism for enabling Android partners to customize features and\n theming.\n\n- Protects the `MANAGE_DOCUMENTS` permission using a signature permission.\n\nDisplay Files launcher icon\n---------------------------\n\nIn Android 10, the DocumentsUI module uses `is_launcher_enabled` to determine if\nthe Files launcher icon should display in the app drawer. In Android\n11 or higher, the module uses the `component-override`\npackage to determine if the Files launcher icon displays in the app drawer.\n\nBy default, the icon is enabled. To disable it, add the following XML to\n`/etc/sysconfig`. \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cconfig\u003e\n \u003ccomponent-override package=\"com.android.documentsui\" \u003e\n \u003ccomponent class=\"com.android.documentsui.LauncherActivity\" enabled=\"false\" /\u003e\n \u003c/component-override\u003e\n \u003c/config\u003e\n\nRequest user data\n-----------------\n\nThe DocumentsUI module implements the `GET_CONTENT` action that enables apps to\nrequest access to other data from the user.\n\nModule format\n-------------\n\nThe DocumentsUI module (`com.android.documentsui`) is delivered as an\nAPK file and is available for devices running Android\n10 or higher.\n\nModule dependencies\n-------------------\n\nThis DocumentsUI module depends on the `MANAGE_DOCUMENTS` permission protected\nby the signature permission; an additional permission class ensures that only\none app on the device has the `MANAGE_DOCUMENTS` permission."]]
