अनुमति से जुड़ी चेतावनी के बारे में दिशा-निर्देश

Chrome एक्सटेंशन, उपयोगकर्ता के ब्राउज़र अनुभव को बेहतर बनाते हैं. ऐसा करने के लिए, ऐसे Chrome API का इस्तेमाल करें जिन्हें कुछ अनुमतियों की ज़रूरत होती है. कुछ अनुमतियों में दखल कम होती है और इनमें चेतावनी नहीं दिखती है. अन्य अनुमतियों से एक चेतावनी मिलती है जिसकी अनुमति उपयोगकर्ताओं को देनी होगी. इस पेज पर, अनुमति से जुड़ी चेतावनियों के साथ काम करने के दिशा-निर्देश दिए गए हैं. खास चेतावनियों को अनुमतियां में, उन अनुमतियों के तहत देखा जाता है जिन पर वे लागू होती हैं.

पहली इमेज: इंस्टॉलेशन के दौरान अनुमति से जुड़ी चेतावनी वाला डायलॉग बॉक्स दिखाया गया.

जब कोई ऐसी नई अनुमति जोड़ी जाती है जो चेतावनी ट्रिगर करती है, तो एक्सटेंशन बंद रहेगा. यह तब तक बंद रहेगा, जब तक उपयोगकर्ता नई अनुमति स्वीकार नहीं कर लेता. इस कार्रवाई को टेस्ट करने का तरीका जानने के लिए, अनुमतियां अपडेट करना देखें.

दूसरी इमेज: एक ऐसा एक्सटेंशन जो तब तक के लिए बंद रहता है, जब तक उपयोगकर्ता नई अनुमति स्वीकार नहीं कर लेता.

हो सकता है कि कुछ अनुमतियों को अन्य अनुमतियों के साथ जोड़े जाने पर चेतावनियां न दिखें. उदाहरण के लिए, अगर एक्सटेंशन "<all_urls>" का अनुरोध भी करता है, तो "tabs" चेतावनी नहीं दिखेगी.

सबसे सही तरीके

अनुमति से जुड़ी चेतावनियों में, एपीआई से मिलने वाली सुविधाओं के बारे में जानकारी दी जाती है. हालांकि, कुछ चेतावनियों को समझने में दूसरों के मुकाबले मुश्किल होती है. उपयोगकर्ताओं के उन एक्सटेंशन को इंस्टॉल करने की संभावना ज़्यादा होती है जो इन दिशा-निर्देशों का पालन करते हैं:

ज़रूरी अनुमतियों का अनुरोध करना

एक्सटेंशन किसी एक मकसद को पूरा करने और अनुमतियों के इस्तेमाल की नीति का पालन करने के लिए ज़रूरी होते हैं. पक्का करें कि आपने सिर्फ़ उन अनुमतियों का अनुरोध किया हो जो एक्सटेंशन के मुख्य फ़ंक्शन के साथ काम करती हों.

वैकल्पिक अनुमतियों का इस्तेमाल करना

रनटाइम के दौरान अनुमतियों के लिए अनुरोध करके, शामिल होने के अनुभव को बेहतर बनाएं. इससे किसी खास अनुमति के बारे में ज़्यादा जानकारी दी जा सकती है. साथ ही, उपयोगकर्ता चुन सकते हैं कि उन्हें कौनसी सुविधाएं चालू करनी हैं. लागू करने से जुड़ी जानकारी के लिए, Permissions API देखें.

"activeTab" अनुमति का इस्तेमाल करना

यह अनुमति, अनुमति से जुड़ी चेतावनी नहीं दिखाती है. यह उस साइट को अस्थायी रूप से होस्ट करने की अनुमति देता है जिस पर उपयोगकर्ता मौजूद है. ज़्यादा जानकारी के लिए, activeTab अनुमति को समझना लेख पढ़ें.

चेतावनियां देखें

किसी एक्सटेंशन को मिली अनुमति से जुड़ी चेतावनियां देखने के लिए, आपके पास ये विकल्प हैं:

एक्सटेंशन अपडेट टेस्टिंग टूल का इस्तेमाल करना

शुरू करने से पहले

1. Node.js और NPM इंस्टॉल करें.
2. Chromium इंस्टॉल करें.
3. extension-update-testing-tool रिपॉज़िटरी का क्लोन बनाएं.
4. रिपॉज़िटरी के रूट में npm install चलाएं.

टूल का इस्तेमाल करना

1. npm start चलाएं.
2. Chromium में, http://localhost:8080 पर स्थानीय सर्वर खोलें.
3. पैक नहीं किए गए किसी एक्सटेंशन (फ़ोल्डर या .zip फ़ाइल) को पेज पर खींचें और छोड़ें.
4. एक्सटेंशन को डाउनलोड और इंस्टॉल करने के लिए, "मैन्युअल तरीके से इंस्टॉल करें" सेक्शन में दिए गए निर्देशों का पालन करें.

एक्सटेंशन को मैन्युअल रूप से पैक करके

1. chrome://extensions पर जाएं
2. डेवलपर मोड चालू करें
3. एक्सटेंशन पैक करें पर क्लिक करें.

   

   तीसरी इमेज: एक्सटेंशन मैनेजमेंट पेज में डेवलपर मोड चालू किया गया

4. एक्सटेंशन रूट डायरेक्ट्री फ़ील्ड में एक्सटेंशन के फ़ोल्डर का पाथ तय करें. पहली बार मिलने वाले पैकेज के लिए, निजी पासकोड फ़ील्ड को अनदेखा करें.

5. एक्सटेंशन पैक करें बटन पर क्लिक करें.

   

   इमेज 4: एक्सटेंशन पाथ की जानकारी देना

6. Chrome दो फ़ाइलें बनाएगा, .crx फ़ाइल और .pem फ़ाइल. .pem फ़ाइल में, एक्सटेंशन पर हस्ताक्षर करने के लिए इस्तेमाल की जाने वाली निजी कुंजी शामिल है. पक्का करें कि आपको याद है कि ये फ़ाइलें किस डायरेक्ट्री में सेव की गई थीं.

   

   पांचवी इमेज: पैकेज की गई एक्सटेंशन फ़ाइलें

7. .pem फ़ाइल को किसी गुप्त और सुरक्षित जगह पर रखें; एक्सटेंशन को अपडेट करने के लिए इसकी ज़रूरत होगी.

8. .crx फ़ाइल को एक्सटेंशन के मैनेजमेंट पेज पर छोड़कर, उसे इंस्टॉल करें.

   

   इमेज 6: इंस्टॉल करने के लिए फ़ाइल को छोड़ें

9. .crx फ़ाइल को हटाने के बाद, ब्राउज़र पूछेगा कि क्या एक्सटेंशन जोड़ा जा सकता है और चेतावनियां दिखाई जा सकती हैं या नहीं.

   

   सातवीं इमेज: नए टैब एक्सटेंशन के लिए चेतावनी

अनुमतियां अपडेट करें

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

यह देखने के लिए कि नई अनुमति जोड़ते समय आपका एक्सटेंशन बंद होगा या नहीं, तो आपके पास ये विकल्प होते हैं:

एक्सटेंशन अपडेट टेस्टिंग टूल का इस्तेमाल करके अपडेट करना

यह तरीका मानकर चलता है कि आपने सर्वर शुरू करने के लिए एक्सटेंशन अपडेट की जांच करने वाले टूल का इस्तेमाल करने से जुड़े निर्देशों का पालन किया है.

टूल का इस्तेमाल करना

1. चेतावनी के साथ नई अनुमति जोड़ें.
2. एक्सटेंशन का वर्शन नंबर बढ़ाएं.
3. पैक नहीं किए गए एक्सटेंशन (फ़ोल्डर या .zip फ़ाइल) को पेज पर खींचें और छोड़ें.
4. chrome://extensions पर जाएं
5. अपडेट करें बटन पर क्लिक करें.

अपना एक्सटेंशन मैन्युअल रूप से अपडेट करें

1. चेतावनियां देखें में, आपने अभी जो .crx फ़ाइल बनाई है उसे ढूंढें.
2. इसका नाम बदलें या इसे मिटाएं.
3. अपना manifest.json खोलें और चेतावनी देने वाली कोई भी अनुमति जोड़ें.
4. chrome://extensions पर जाएं पहले से इंस्टॉल किए गए पैकेज को न हटाएं.
5. एक्सटेंशन को फिर से पैक करें, लेकिन इस बार दूसरे इनपुट में pem फ़ाइल जोड़ें.

   

   आठवीं इमेज: पेम फ़ाइल के साथ पैकिंग एक्सटेंशन डायलॉग शामिल है.

6. नए पैकेज किए गए एक्सटेंशन को खींचकर एक्सटेंशन मैनेजमेंट पेज पर छोड़ें.

7. आपको एक डायलॉग दिखेगा, जो लोगों को नई अनुमतियां स्वीकार करने के लिए कहेगा.

   

   नौवीं इमेज: बंद किए गए एक्सटेंशन की चेतावनी

   

   पहली इमेज: अनुमति के लिए नए डायलॉग का अनुरोध करना