اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتحكّم وحدة DocumentsUI في الوصول إلى ملفات معيّنة للمكونات التي تعالج أذونات المستندات (مثل إرفاق ملف برسالة إلكترونية). هذه الوحدة
قابلة للتحديث، ما يعني أنّه يمكنها تلقّي تحديثات للوظائف خارج
دورة إصدار Android العادية.
يؤدي تحويل أذونات الوصول إلى مساحة التخزين إلى وحدة إلى تعزيز الخصوصية
والأمان للمستخدمين النهائيين، مع السماح لشركاء Android بتخصيص ميزات
وموضوعات التطبيق من خلال عمليات تراكب الموارد أثناء التشغيل
(RRO). يضمن تنسيق الوحدة أن يتم شحن جميع
الأجهزة مع تجربة DocumentsUI نفسها، ما يتيح للمطوّرين معرفة
ما يظهر للمستخدمين في واجهات برمجة التطبيقات المرتبطة.
تعالج وحدة DocumentsUI الإجراءات التالية:
لا تتفاعل مع الإطار إلا من خلال واجهات برمجة تطبيقات @SystemApi الثابتة (لا يتم استخدام
@hide API).
يوفّر آلية تتيح لشركاء Android تخصيص الميزات و
المظاهر.
حماية إذن MANAGE_DOCUMENTS باستخدام إذن التوقيع
رمز مشغّل "عرض الملفات"
في Android 10، تستخدِم وحدة DocumentsUI is_launcher_enabled لتحديد ما إذا كان ينبغي عرض
رمز مشغّل تطبيق "الملفات" في درج التطبيقات. في الإصدار
11 من نظام التشغيل Android أو الإصدارات الأحدث، تستخدِم الوحدة حزمة component-override
لتحديد ما إذا كان سيتم عرض رمز مشغّل "ملفات Google" في درج التطبيقات.
يكون الرمز مفعَّلاً تلقائيًا. لإيقاف هذه الميزة، أضِف ملف XML التالي إلى
/etc/sysconfig.
تنفِّذ وحدة DocumentsUI الإجراء GET_CONTENT الذي يتيح للتطبيقات
طلب الوصول إلى بيانات أخرى من المستخدم.
تنسيق الوحدة
يتم عرض وحدة DocumentsUI (com.android.documentsui) كملف APK، وهي متاحة للأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android أو إصدار أحدث.
الوحدات التابعة
تعتمد وحدة DocumentsUI هذه على إذن MANAGE_DOCUMENTS المحمي
بإذن التوقيع، وتؤكّد فئة إذن إضافية أنّه ليس سوى
تطبيق واحد على الجهاز لديه إذن MANAGE_DOCUMENTS.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
