Chrome, वेब ऐप्लिकेशन मेनिफ़ेस्ट के अपडेट कैसे मैनेज करता है

आपके PWA के आइकॉन, शॉर्टकट, रंग, और अन्य मेटाडेटा में बदलाव करने के लिए क्या ज़रूरी है

एड्रियाना जारा

फ़्रैंकोइस ब्यूफ़ोर्ट

पीट लीपेज

ध्यान दें: फ़िलहाल, हम Chrome के अलावा अन्य ब्राउज़र पर डेटा इकट्ठा कर रहे हैं. अगर आप यह डेटा इकट्ठा करने या इस पेज में कॉन्टेंट जोड़ने में हमारी मदद करना चाहें, तो कृपया समस्या #4038 में अपनी टिप्पणी दें.

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

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

ज़्यादातर मामलों में, मेनिफ़ेस्ट के अपडेट होने के बाद, बदलाव, PWA के लॉन्च होने के एक या दो दिन के अंदर दिखने चाहिए.

डेस्कटॉप Chrome पर अपडेट

जब PWA को लॉन्च किया गया है या उसे ब्राउज़र टैब में खोला गया है, तो Chrome यह तय करता है कि पिछली बार लोकल मेनिफ़ेस्ट में बदलावों की जांच कब की गई थी. अगर ब्राउज़र के आखिरी बार शुरू होने के बाद से मेनिफ़ेस्ट की जांच नहीं की गई है या पिछले 24 घंटों में इसकी जांच नहीं की गई है, तो Chrome, मेनिफ़ेस्ट के लिए नेटवर्क अनुरोध करेगा. इसके बाद, इसकी तुलना लोकल कॉपी से करें.

अगर मेनिफ़ेस्ट की चुनिंदा प्रॉपर्टी बदल गई हैं (नीचे दी गई सूची देखें), तो Chrome नए मेनिफ़ेस्ट को सूची में दिखाता है और सभी विंडो बंद होने के बाद, उसे इंस्टॉल करता है. इंस्टॉल करने के बाद, नए मेनिफ़ेस्ट के सभी फ़ील्ड (name, short_name, और icons को छोड़कर) अपडेट हो जाते हैं.

किन प्रॉपर्टी से अपडेट होगा?

• display (नीचे देखें)
• scope
• shortcuts
• start_url
• theme_color
• file_handlers

चेतावनी: name, short_name, और icons में किए गए बदलाव, फ़िलहाल डेस्कटॉप Chrome पर नहीं काम करते हैं. हालांकि, इन बदलावों को लागू करने के लिए काम चल रहा है.

चेतावनी: start_url में बदलाव करने के लिए, मेनिफ़ेस्ट id को सेट करना ज़रूरी है. ज़्यादा जानकारी

display फ़ील्ड को अपडेट करने पर क्या होता है?

अगर ऐप्लिकेशन के डिसप्ले मोड को browser से standalone में अपडेट किया जाता है, तो अपडेट करने के बाद, आपके मौजूदा उपयोगकर्ताओं के ऐप्लिकेशन किसी विंडो में नहीं खुलेंगे. किसी वेब ऐप्लिकेशन के लिए दो डिसप्ले सेटिंग होती हैं, एक मेनिफ़ेस्ट (जिसे आप कंट्रोल करते हैं) और दूसरी विंडो/ब्राउज़र टैब सेटिंग, जिसे उपयोगकर्ता कंट्रोल करता है. उपयोगकर्ता की प्राथमिकता को हमेशा अहमियत दी जाती है.

मेनिफ़ेस्ट के अपडेट की जांच करना

chrome://web-app-internals पेज (Chrome 85 या उसके बाद के वर्शन में उपलब्ध) में, डिवाइस पर इंस्टॉल किए गए सभी PWA के बारे में ज़्यादा जानकारी शामिल होती है. इससे, आपको यह समझने में मदद मिलती है कि मेनिफ़ेस्ट को पिछली बार कब अपडेट किया गया है और इसे कितनी बार अपडेट किया गया है.

अपडेट किए गए मेनिफ़ेस्ट की जांच मैन्युअल तरीके से करने के लिए, Chrome को कमांड लाइन फ़्लैग --disable-manifest-update-throttle के साथ लॉन्च किया जा सकता है या Chrome को रीस्टार्ट किया जा सकता है (about://restart का इस्तेमाल करें). इससे टाइमर रीसेट हो जाता है, ताकि अगली बार PWA लॉन्च होने पर Chrome अपडेट किए गए मेनिफ़ेस्ट की जांच कर सके. इसके बाद, PWA लॉन्च करें. PWA को बंद करने के बाद, उसे नई मेनिफ़ेस्ट प्रॉपर्टी के साथ अपडेट किया जाना चाहिए.

References

• अपडेट किए जा सकने वाले वेब मेनिफ़ेस्ट फ़ील्ड

Android के लिए Chrome पर अपडेट

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

अगर मेनिफ़ेस्ट की चुनिंदा प्रॉपर्टी बदल गई हैं (नीचे दी गई सूची देखें), Chrome नए मेनिफ़ेस्ट को सूची में डालें, और PWA की सभी विंडो बंद होने के बाद, डिवाइस प्लग इन हो जाए और वाई-फ़ाई से कनेक्ट हो जाए, तो Chrome, सर्वर से अपडेट किए गए WebAPK का अनुरोध करता है. अपडेट होने के बाद, नए मेनिफ़ेस्ट के सभी फ़ील्ड इस्तेमाल किए जाते हैं.

किन प्रॉपर्टी से अपडेट होगा?

• background_color
• display
• orientation
• scope
• shortcuts
• start_url
• theme_color
• web_share_target

अगर Chrome को सर्वर से अपडेट किया गया मेनिफ़ेस्ट नहीं मिलता, तो यह जांच के बीच के समय को 30 दिनों तक बढ़ा सकता है.

चेतावनी: name, short_name, और icons में किए गए बदलाव, फ़िलहाल Android Chrome पर काम नहीं करते. हालांकि, इन पर काम किया जा रहा है.

मेनिफ़ेस्ट के अपडेट की जांच करना

about://webapks पेज पर, डिवाइस पर इंस्टॉल किए गए सभी PWA के बारे में पूरी जानकारी मौजूद होती है. साथ ही, पेज पर आपको यह बताया जा सकता है कि मेनिफ़ेस्ट को पिछली बार कब अपडेट किया गया था, उसे कितनी बार अपडेट किया गया है वगैरह.

मेनिफ़ेस्ट में अपडेट को मैन्युअल तरीके से शेड्यूल करने के लिए, टाइमर और लोकल मेनिफ़ेस्ट को बदलने के लिए ये काम करें:

1. डिवाइस को प्लग इन करें और सुनिश्चित करें कि वह वाई-फ़ाई से कनेक्ट है.
2. Android टास्क मैनेजर का इस्तेमाल करके PWA को शट डाउन करें, फिर Android सेटिंग में ऐप्लिकेशन पैनल का इस्तेमाल करके PWA को ज़बरदस्ती रोकें.
3. Chrome में, about://webapks खोलें और PWA के लिए "अपडेट करें" बटन पर क्लिक करें. "अपडेट का स्टेटस", "मंज़ूरी बाकी है" में बदलना चाहिए.
4. PWA लॉन्च करें और पुष्टि करें कि यह ठीक से लोड हो गया है.
5. Android टास्क मैनेजर का इस्तेमाल करके PWA को शट डाउन करें, फिर Android सेटिंग में ऐप्लिकेशन पैनल का इस्तेमाल करके PWA को ज़बरदस्ती रोकें.

आम तौर पर, अपडेट पूरा होने के बाद PWA कुछ ही मिनट में अपडेट हो जाता है. "अपडेट का स्टेटस", "अपडेट हो गया" में बदल जाता है

References

• Android पर Chrome के लिए UpdateReason enum