از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ماژول DocumentsUI دسترسی به فایلهای خاص را برای اجزایی که مجوزهای سند را کنترل میکنند (مانند پیوست کردن یک فایل به ایمیل) کنترل میکند. این ماژول قابل بهروزرسانی است، به این معنی که میتواند بهروزرسانیهای عملکرد را خارج از چرخه انتشار عادی اندروید دریافت کند.
ایجاد دسترسی و مجوزهای فضای ذخیرهسازی در یک ماژول، حریم خصوصی و امنیت را برای کاربران نهایی افزایش میدهد و در عین حال به شرکای Android اجازه میدهد تا ویژگیها و موضوعبندی برنامه را از طریق پوششهای منابع زمان اجرا (RRO) سفارشی کنند. قالب ماژول تضمین میکند که همه دستگاهها با تجربه DocumentsUI یکسان عرضه میشوند، و به توسعهدهندگان این امکان را میدهد تا بدانند کاربران برای APIهای مرتبط چه میبینند.
ماژول DocumentsUI اقدامات زیر را انجام می دهد.
فقط از طریق API های پایدار @SystemApi (بدون استفاده از @hide API) با چارچوب تعامل دارد.
مکانیزمی را نشان می دهد که شرکای Android را قادر می سازد ویژگی ها و موضوع را سفارشی کنند.
با استفاده از مجوز امضا از مجوز MANAGE_DOCUMENTS محافظت می کند.
نمایش نماد راهانداز فایلها
در اندروید 10، ماژول DocumentsUI از is_launcher_enabled برای تعیین اینکه آیا نماد راهانداز فایلها باید در کشوی برنامه نمایش داده شود، استفاده میکند. در اندروید 11 یا بالاتر، این ماژول از بسته component-override برای تعیین اینکه آیا نماد راهانداز فایلها در کشوی برنامه نمایش داده میشود، استفاده میکند.
به طور پیش فرض، نماد فعال است. برای غیرفعال کردن آن، XML زیر را به /etc/sysconfig اضافه کنید.
ماژول DocumentsUI عمل GET_CONTENT را اجرا میکند که به برنامهها امکان میدهد از کاربر درخواست دسترسی به دادههای دیگر کنند.
فرمت ماژول
ماژول DocumentsUI ( com.android.documentsui ) بهعنوان یک فایل APK ارائه میشود و برای دستگاههای دارای Android 10 یا بالاتر در دسترس است.
وابستگی های ماژول
این ماژول DocumentsUI به مجوز MANAGE_DOCUMENTS بستگی دارد که توسط مجوز امضا محافظت می شود. یک کلاس مجوز اضافی تضمین می کند که فقط یک برنامه در دستگاه دارای مجوز MANAGE_DOCUMENTS است.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]