डॉक्यूमेंट यूज़र इंटरफ़ेस (यूआई)

DocumentsUI मॉड्यूल, उन कॉम्पोनेंट के लिए चुनिंदा फ़ाइलों का ऐक्सेस कंट्रोल करता है जो दस्तावेज़ की अनुमतियों को मैनेज करते हैं. जैसे, किसी फ़ाइल को ईमेल से अटैच करना. इस मॉड्यूल को अपडेट किया जा सकता है. इसका मतलब है कि इसे Android के सामान्य रिलीज़ साइकल के बाहर भी अपडेट किया जा सकता है.

स्टोरेज ऐक्सेस और अनुमतियों को मॉड्यूल में बदलने से, असली उपयोगकर्ताओं की निजता और सुरक्षा बढ़ती है. साथ ही, Android पार्टनर को रनटाइम रिसॉर्स ओवरले (आरआरओ) की मदद से, ऐप्लिकेशन की सुविधाओं और थीम को पसंद के मुताबिक बनाने की सुविधा मिलती है. मॉड्यूल फ़ॉर्मैट से यह पक्का होता है कि सभी डिवाइसों पर DocumentsUI का एक जैसा अनुभव मिले. इससे डेवलपर को यह जानने में मदद मिलती है कि उपयोगकर्ताओं को इससे जुड़े एपीआई के लिए क्या दिखता है.

DocumentsUI मॉड्यूल, इन कार्रवाइयों को मैनेज करता है.

• यह सिर्फ़ स्थिर @SystemApi एपीआई के ज़रिए फ़्रेमवर्क के साथ इंटरैक्ट करता है (@hide एपीआई का इस्तेमाल नहीं किया जाता).

• Android पार्टनर को सुविधाओं और थीम को पसंद के मुताबिक बनाने की सुविधा देने के लिए, एक तरीका दिखाता है.

• हस्ताक्षर करने की अनुमति का इस्तेमाल करके, MANAGE_DOCUMENTS की अनुमति सुरक्षित रखता है.

Files लॉन्चर आइकॉन दिखाएं

Android 10 में, DocumentsUI मॉड्यूल is_launcher_enabled का इस्तेमाल करके यह तय करता है कि Files लॉन्चर आइकॉन को ऐप्लिकेशन ड्रॉअर में दिखाया जाना चाहिए या नहीं. Android 11 या उसके बाद के वर्शन में, मॉड्यूल component-override पैकेज का इस्तेमाल करके यह तय करता है कि ऐप्लिकेशन ड्रॉअर में Files लॉन्चर आइकॉन दिखेगा या नहीं.

डिफ़ॉल्ट रूप से, यह आइकॉन चालू होता है. इसे बंद करने के लिए, /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 अनुमति मिली हो.