शेयर किए गए स्टोरेज को ऐक्सेस करने की ज़रूरत वाले ज़्यादातर ऐप्लिकेशन, मीडिया फ़ाइलें शेयर करने और नॉन-मीडिया फ़ाइलें शेयर करने के सबसे सही तरीके अपना सकते हैं. हालांकि, कुछ ऐप्लिकेशन का मुख्य फ़ंक्शन ऐसा होता है जिसके लिए उन्हें डिवाइस पर मौजूद फ़ाइलों को बड़े पैमाने पर ऐक्सेस करने की ज़रूरत होती है. हालांकि, वे निजता को बनाए रखने वाले स्टोरेज के सबसे सही तरीकों का इस्तेमाल करके, फ़ाइलों को बेहतर तरीके से ऐक्सेस नहीं कर पाते. Android, ऐसी स्थितियों के लिए ऐप्लिकेशन को सभी फ़ाइलों का ऐक्सेस नाम का एक खास ऐक्सेस देता है.
उदाहरण के लिए, किसी एंटी-वायरस ऐप्लिकेशन के मुख्य इस्तेमाल के लिए, अलग-अलग डायरेक्ट्री में मौजूद कई फ़ाइलों को नियमित तौर पर स्कैन करने की ज़रूरत पड़ सकती है. अगर इस स्कैनिंग के लिए, सिस्टम फ़ाइल पिकर का इस्तेमाल करके डायरेक्ट्री चुनने के लिए, उपयोगकर्ता को बार-बार इंटरैक्ट करना पड़ता है, तो इससे उपयोगकर्ता को खराब अनुभव मिलता है. इस्तेमाल के अन्य उदाहरणों के लिए भी इसी तरह की बातों का ध्यान रखना ज़रूरी है. जैसे, फ़ाइल मैनेजर ऐप्लिकेशन, बैकअप लेने और डेटा वापस लाने वाले ऐप्लिकेशन, और दस्तावेज़ मैनेज करने वाले ऐप्लिकेशन.
सभी फ़ाइलों को ऐक्सेस करने की अनुमति का अनुरोध करना
कोई ऐप्लिकेशन, उपयोगकर्ता से सभी फ़ाइलों को ऐक्सेस करने का अनुरोध कर सकता है. इसके लिए, उसे ये काम करने होंगे:
- मेनिफ़ेस्ट में
MANAGE_EXTERNAL_STORAGEअनुमति का एलान करें. ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSIONइंटेंट ऐक्शन का इस्तेमाल करके, उपयोगकर्ताओं को सिस्टम सेटिंग पेज पर ले जाएं. यहां वे आपके ऐप्लिकेशन के लिए, यह विकल्प चालू कर सकते हैं: सभी फ़ाइलों को मैनेज करने का ऐक्सेस दें.
यह पता लगाने के लिए कि आपके ऐप्लिकेशन को MANAGE_EXTERNAL_STORAGE
अनुमति दी गई है या नहीं,
Environment.isExternalStorageManager() को कॉल करें.
MANAGE_EXTERNAL_STORAGE से अनुमति मिलने पर की जा सकने वाली कार्रवाइयां
MANAGE_EXTERNAL_STORAGE की अनुमति देने पर, ये काम किए जा सकते हैं:
शेयर किए गए स्टोरेज में मौजूद सभी फ़ाइलों को पढ़ने और उनमें बदलाव करने का ऐक्सेस.
MediaStore.Filesटेबल के कॉन्टेंट का ऐक्सेस.यूएसबी ऑन-द-गो (ओटीजी) ड्राइव और एसडी कार्ड, दोनों की रूट डायरेक्ट्री का ऐक्सेस.
डिवाइस के स्टोरेज की सभी डायरेक्ट्री में डेटा सेव करने का ऐक्सेस. हालांकि,
/Android/data/,/sdcard/Android, और/sdcard/Androidकी ज़्यादातर सबडायरेक्ट्री में डेटा सेव नहीं किया जा सकता. इस ऐक्सेस में, डायरेक्ट फ़ाइल पाथ का ऐक्सेस भी शामिल है.जिन ऐप्लिकेशन को यह अनुमति दी गई है वे अब भी दूसरे ऐप्लिकेशन की ऐप्लिकेशन के लिए खास डायरेक्ट्री को ऐक्सेस नहीं कर सकते. ऐसा इसलिए, क्योंकि ये डायरेक्ट्री, स्टोरेज वॉल्यूम पर
Android/data/की सबडायरेक्ट्री के तौर पर दिखती हैं.
अगर किसी ऐप्लिकेशन के पास MANAGE_EXTERNAL_STORAGE की अनुमति है, तो वह MediaStore एपीआई या डायरेक्ट फ़ाइल पाथ का इस्तेमाल करके, इन अतिरिक्त फ़ाइलों और डायरेक्ट्री को ऐक्सेस कर सकता है. हालांकि, स्टोरेज ऐक्सेस फ़्रेमवर्क का इस्तेमाल करने पर, किसी फ़ाइल या डायरेक्ट्री को सिर्फ़ तब ऐक्सेस किया जा सकता है, जब आपके पास MANAGE_EXTERNAL_STORAGE अनुमति न हो.
किसी दूसरे ऐप्लिकेशन के स्टोरेज को मैनेज करने की गतिविधि को शुरू करना
Android 12 (एपीआई लेवल 31) और इसके बाद के वर्शन पर, जिन ऐप्लिकेशन के पास
MANAGE_EXTERNAL_STORAGE
और
QUERY_ALL_PACKAGES
दोनों अनुमतियां होती हैं वे
getManageSpaceActivityIntent()
का इस्तेमाल करके, उपयोगकर्ताओं को किसी दूसरे ऐप्लिकेशन की कस्टम स्पेस मैनेजमेंट
ऐक्टिविटी पर भेज सकते हैं. फ़ाइल मैनेजमेंट ऐप्लिकेशन के पास ये दोनों अनुमतियां होती हैं.
getManageSpaceActivityIntent() तरीके में, पैकेज का नाम और अनुरोध कोड डाला जाता है. इसके बाद, यह इनमें से कोई एक नतीजा दिखाता है:
- अगर पैकेज के नाम वाले ऐप्लिकेशन में, "स्पेस मैनेज करें" गतिविधि को कस्टम के तौर पर तय किया गया है, तो
PendingIntent. इसके बाद,getManageSpaceActivityIntent()तरीके को कॉल करने वाला फ़ाइल मैनेजमेंट ऐप्लिकेशन, उपयोगकर्ताओं को कस्टम गतिविधि पर भेजने के लिए, दिखाए गए इंटेंट को शुरू कर सकता है. null, अगर पैकेज के नाम वाले ऐप्लिकेशन में "स्पेस मैनेज करें" गतिविधि के बारे में नहीं बताया गया है.
टेस्टिंग के लिए MANAGE_EXTERNAL_STORAGE को चालू करना
MANAGE_EXTERNAL_STORAGE की अनुमति से आपके ऐप्लिकेशन पर क्या असर पड़ता है, यह जानने के लिए टेस्टिंग के लिए अनुमति चालू की जा सकती है. इसके लिए, टेस्ट डिवाइस से कनेक्ट की गई मशीन पर यह कमांड चलाएं:
adb shell appops set --uid PACKAGE_NAME MANAGE_EXTERNAL_STORAGE allow
Google Play की सूचना
इस सेक्शन में, Google Play पर ऐप्लिकेशन पब्लिश करने वाले डेवलपर के लिए एक सूचना दी गई है.
शेयर किए गए स्टोरेज के ऐक्सेस को सीमित करने के लिए, Google Play Store ने अपनी नीति को अपडेट किया है. इससे Android 11 (एपीआई लेवल 30) या इसके बाद के वर्शन को टारगेट करने वाले और MANAGE_EXTERNAL_STORAGE अनुमति के ज़रिए सभी फ़ाइलों के ऐक्सेस का अनुरोध करने वाले ऐप्लिकेशन का आकलन किया जा सकेगा. यह नीति मई 2021 से लागू है.
जब आपका ऐप्लिकेशन Android 11 या इसके बाद के वर्शन को टारगेट करता है और MANAGE_EXTERNAL_STORAGE अनुमति का एलान करता है, तो Android Studio, लिंट की चेतावनी दिखाता है. यह चेतावनी पहली इमेज में दिखती है. इस चेतावनी से आपको याद दिलाया जाता है कि Google Play Store की एक नीति है, जो अनुमति के इस्तेमाल को सीमित करती है.
MANAGE_EXTERNAL_STORAGE की अनुमति के बारे में Google Play की नीति की याद दिलाती है.
MANAGE_EXTERNAL_STORAGE की अनुमति का अनुरोध सिर्फ़ तब करें, जब आपका ऐप्लिकेशन, निजता को बनाए रखने वाली एपीआई का सही ढंग से इस्तेमाल न कर पाए. जैसे, स्टोरेज ऐक्सेस फ़्रेमवर्क या मीडिया स्टोर एपीआई. ऐप्लिकेशन को मिली अनुमति का इस्तेमाल, उन मामलों में ही करना चाहिए जिनके लिए मंज़ूरी मिली हुई है. साथ ही, इसका इस्तेमाल ऐप्लिकेशन के मुख्य फ़ंक्शन से सीधे जुड़ा होना चाहिए. अगर आपके ऐप्लिकेशन में इस्तेमाल का कोई ऐसा उदाहरण शामिल है जो इनमें से किसी से मिलता-जुलता है, तो हो सकता है कि वह MANAGE_EXTERNAL_STORAGE अनुमति का अनुरोध कर सके:
- फ़ाइल मैनेजर
- डेटा का बैक अप लेने और उसे वापस पाने की सुविधा देने वाले ऐप्लिकेशन
- एंटी-वायरस वाले ऐप्लिकेशन
- दस्तावेज़ मैनेज करने वाले ऐप्लिकेशन
- डिवाइस पर मौजूद फ़ाइलें खोजना
- डिस्क और फ़ाइल को एन्क्रिप्ट (सुरक्षित) करने की सुविधा
- एक डिवाइस से दूसरे डिवाइस पर डेटा माइग्रेट करना