1. आपका स्वागत है
इस लैब में, आपको एक मौजूदा प्रोग्रेसिव वेब ऐप्लिकेशन लेना होगा जिसे आपने Google के Play Store पर उपलब्ध कराने के लिए, डिप्लॉय किया है. साथ ही, उसे ऐप्लिकेशन में रैप कर दिया है.
आप इन चीज़ों के बारे में जानेंगे
- Google Play का इस्तेमाल करके प्रोग्रेसिव वेब ऐप्लिकेशन का पैकेज इस्तेमाल करने का तरीका
- साइनिंग कुंजी क्या है और इसका इस्तेमाल कैसे किया जाता है
- Google Play's के डेवलपर कंसोल में नया ऐप्लिकेशन बनाने का तरीका और प्रकाशन से पहले अपने ऐप्लिकेशन की जांच करने के लिए टेस्टिंग रिलीज़ सेट अप करने का तरीका
- डिजिटल एसेट लिंक क्या हैं और इन्हें अपने वेबऐप्लिकेशन में कैसे जोड़ें
आपको क्या पता होना चाहिए
- प्रोग्रेसिव वेब ऐप्लिकेशन क्या हैं
- कमांड लाइन टूल इस्तेमाल करने का तरीका
- बुनियादी बैश शेल निर्देश या उनका अपनी पसंद के शेल में अनुवाद करने का तरीका
आपको इनकी ज़रूरत होगी
- एक प्रगतिशील वेब ऐप्लिकेशन जो इंटरनेट पर लाइव प्रकाशित हुआ है और आप उसमें बदलाव कर सकते हैं
- बबल रैप कमांड लाइन इंटरफ़ेस इंस्टॉल किया गया है और यह इस्तेमाल के लिए तैयार है
- Google Play डेवलपर खाता
- अगर आपने पहले से ही Google Play में ऐप्लिकेशन लॉन्च किए हुए हैं, तो आपकी मौजूदा साइनिंग कुंजी
- वह Android या Chrome OS डिवाइस जिस पर जांच की जा सकती है
इसमें क्या शामिल नहीं होगा
- अपने PWA को सिर्फ़ Android या सिर्फ़ Chrome OS डिवाइसों तक सीमित करना
- एक ही ऐप्लिकेशन में Chrome डिवाइसों के लिए PWA और मोबाइल डिवाइस के लिए Android ऐप्लिकेशन डिप्लॉय करना.
- PWA में Google Play की पेमेंट से जुड़ी नीति का पालन कैसे करें.
2. अपने PWA को बबल रैप करना
बबल रैप एक ऐसा टूल है जो आपके प्रगतिशील वेब ऐप्लिकेशन को किसी Android ऐप्लिकेशन बंडल में रैप कर देता है. यह कुछ सीएलआई निर्देश चलाने जितना आसान है. ऐसा करने के लिए एक ऐसा Android प्रोजेक्ट जनरेट किया जाता है जो आपके PWA को भरोसेमंद वेब गतिविधि के तौर पर लॉन्च करता है.
शुरू करने के लिए, अपने प्रोजेक्ट की डायरेक्ट्री बनाएं और उसमें जाएं:
$ mkdir my-pwa && cd my-pwa
इसके बाद, बबल रैप करने के लिए कमांड लाइन टूल का इस्तेमाल करके, उस Android ऐप्लिकेशन बंडल को कॉन्फ़िगर करें और Android प्रोजेक्ट बनाएं जिसे आप #39;Play पर अपलोड करेंगे:
$ bubblewrap init --manifest=https://my-pwa.com/manifest.json
यहां, बबल रैप करने की शुरुआत PWA' की वेब ऐप्लिकेशन मेनिफ़ेस्ट फ़ाइल की जगह से की जाती है. इससे वेब ऐप्लिकेशन मेनिफ़ेस्ट से एक डिफ़ॉल्ट कॉन्फ़िगरेशन जनरेट होगा और एक इन-कंसोल कंसोल से शुरू होगा, जो आपको डिफ़ॉल्ट कॉन्फ़िगरेशन बदलने की अनुमति देगा. टूल से जनरेट की गई किसी भी वैल्यू को बदलने के लिए विज़ार्ड का पालन करें.
साइनिंग कुंजी
Google Play के Play Store के लिए ज़रूरी है कि अपलोड किए जाने पर, ऐप्लिकेशन पैकेज को सर्टिफ़िकेट के साथ डिजिटल रूप से साइन किया जाए. इसे अक्सर 'साइनिंग की' भी कहा जाता है. यह खुद पर हस्ताक्षर किया गया सर्टिफ़िकेट है. यह एचटीटीपीएस पर आपका आवेदन सबमिट करने के लिए इस्तेमाल किए जाने वाले सर्टिफ़िकेट से अलग है.
बबलर ऐप्लिकेशन बनाते समय कुंजी का पाथ मांगेगा. अगर आप अपने ऐप्लिकेशन के लिए किसी मौजूदा 'Play Store' की लिस्टिंग का इस्तेमाल कर रहे हैं, तो आपको उस सूची में इस्तेमाल की गई कुंजी को ही जोड़ना होगा.
अगर आपके पास मौजूदा साइनिंग कुंजी नहीं है और आप 'Play स्टोर' पर नई लिस्टिंग बना रहे हैं, तो आप बबलबैप की ओर से दी गई डिफ़ॉल्ट वैल्यू का इस्तेमाल करके, आपके लिए नई कुंजी बना सकते हैं:
बबल रैप आउटपुट
आपका बबलरप प्रोजेक्ट शुरू करने और विज़ार्ड पूरा करने के बाद, ये आइटम बना दिए जाएंगे:
- twa-manifest.json - बबल कॉन्फ़िगरेशन में चुने गए मान दिखाने वाला प्रोजेक्ट कॉन्फ़िगरेशन. इस फ़ाइल को अपने वर्शन कंट्रोल सिस्टम से ट्रैक करना होगा, क्योंकि इसका इस्तेमाल ज़रूरत होने पर पूरे बबलब प्रोजेक्ट को फिर से जनरेट करने के लिए किया जा सकता है.
- Android प्रोजेक्ट फ़ाइलें - डायरेक्ट्री में बची हुई फ़ाइलें, जनरेट की गई Android प्रोजेक्ट होती हैं. इस प्रोजेक्ट का इस्तेमाल, बबल रैप करने के निर्देश के लिए किया जाता है. आप चाहें, तो इन फ़ाइलों को भी अपने वर्शन कंट्रोल सिस्टम की मदद से ट्रैक कर सकते हैं.
- (वैकल्पिक रूप से) साइनिंग कुंजी - अगर आप बबलर के लिए साइनिंग कुंजी बनाने का विकल्प चुनते हैं, तो कुंजी को विज़ार्ड में बताई गई जगह पर ले जाया जाएगा. पक्का करें कि यह कुंजी किसी सुरक्षित जगह पर रखी गई हो और यह उन लोगों की संख्या सीमित कर सके जिनके पास इसका ऐक्सेस है. इसका इस्तेमाल, Play Store पर मौजूद ऐप्लिकेशन की पुष्टि करने के लिए किया जाता है.
इन फ़ाइलों के साथ, अब हमारे पास Android ऐप्लिकेशन बंडल बनाने के लिए ज़रूरी सभी चीज़ें हैं.
अपना 'Android ऐप्लिकेशन बंडल' बनाना
उसी डायरेक्ट्री में जहां आपने बबलबेड' इनीशियलाइज़ेशन कमांड चलाया था, आगे दिए गए निर्देश चलाएं (आपको'आपकी साइनिंग कुंजी के पासवर्ड की ज़रूरत होगी):
$ bubblewrap build
बिल्ड निर्देश दो ज़रूरी फ़ाइलें जनरेट करेगा:
- app-release-bundle.aab - आपके PWA's का Android ऐप्लिकेशन बंडल. यह वह फ़ाइल है जिसे आप Google Play Store में अपलोड करेंगे.
- app-release-signed.apk - यह एक Android पैकेजिंग फ़ॉर्मैट है, जिसका इस्तेमाल
bubblewrap install
निर्देश का इस्तेमाल करके ऐप्लिकेशन को सीधे डेवलपमेंट डिवाइस पर इंस्टॉल करने के लिए किया जा सकता है.
3. इसे आज़माएं - बबल रैप
अब यह आपकी बारी है! पिछले चरण में आपने जो सीखा था उसका इस्तेमाल करके, नीचे दिए गए तरीके आज़माएं:
- अपने जनरेट किए गए Android प्रोजेक्ट को होल्ड करने के लिए, डायरेक्ट्री बनाएं.
- उस डायरेक्ट्री को बबलबैप और अपने PWA's के वेब ऐप्लिकेशन मेनिफ़ेस्ट से शुरू करें.
- नई साइनिंग कुंजी जनरेट करें. अगर आपके पास साइनिंग कुंजी है, तो उनका इस्तेमाल करें.
- जनरेट किए गए Android प्रोजेक्ट से अपना Android ऐप्लिकेशन बंडल बनाएं.
4. Google Play के ऐप्लिकेशन को Google Play Store में जोड़ा जा रहा है
अब आपके पास अपने PWA के लिए 'Android ऐप्लिकेशन बंडल' है, तो उसे Google's Play Store पर अपलोड करें! डेवलपर खाता रजिस्टर करने के बाद, आप Play Console में लॉग इन करके शुरुआत कर सकते हैं.
ऐप्लिकेशन बनाना
लॉग इन हो जाने के बाद, आपको एक स्क्रीन दिखाई देगी जिस पर आपके सभी ऐप्लिकेशन दिखेंगे. सबसे ऊपर, ऐप्लिकेशन बनाएं बटन दिखेगा. इस बटन पर क्लिक करने से, नीचे दी गई स्क्रीन पर नई Android ऐप्लिकेशन लिस्टिंग बनाने के बारे में जानकारी मिलेगी.
यहां कई फ़ील्ड भरे जाते हैं, जैसे कि ऐप्लिकेशन का नाम, डिफ़ॉल्ट भाषा, यह ऐप्लिकेशन या गेम है या नहीं, यह मुफ़्त है या पैसे देकर लिया गया है, और कई एलान किए गए हैं. आप अनुमतियों की सहमति दिए बिना कोई ऐप्लिकेशन नहीं बना पाएंगे. इसलिए, यह ज़रूरी है कि आप सहमत होने से पहले उन्हें पढ़ लें और उन्हें समझ लें.
जब आप सभी जानकारी भर लें और फ़ॉर्म में सबसे नीचे मौजूद ऐप्लिकेशन बनाएं बटन पर क्लिक करें, तब आपको #39; अपने नए ऐप्लिकेशन के डैशबोर्ड पर ले जाया जाएगा. डैशबोर्ड में आपको #39 टास्क दिखेंगे. इसे सेट अप करने, जांच शुरू करने, और अपने ऐप्लिकेशन को रिलीज़ करने के लिए, आपको इन चेकलिस्ट को पूरा करना होगा.
संगठन में काम करने वालों के लिए उपलब्ध जांच सेट अप करना
संगठन में काम करने वालों के लिए उपलब्ध जांच की सुविधा, अपने ऐप्लिकेशन को तेज़ी से रिलीज़ कराने का एक बेहतरीन तरीका है. जांच के लिए, उन टेस्टर के ग्रुप की समीक्षा नहीं कराई जाती है जिन्हें आपने चुना है. अभी जांच शुरू करें चेकलिस्ट में टास्क देखें और जांच करने वाले लोग चुनें को चुनें.
उस टास्क पर क्लिक करने से आप संगठन में काम करने वालों के लिए उपलब्ध जांच वाले पेज पर पहुंच जाएंगे. यहां आप अपने ऐप्लिकेशन के लिए टेस्टिंग सेट अप मैनेज करेंगे. आप साइडबार में रिलीज़ मेन्यू में जाकर, जांच सेक्शन में जाकर, फिर से नेविगेट कर सकते हैं. सबसे पहले अपने ऐप्लिकेशन की जांच करने के लिए, जांच करने वाले लोगों की एक ईमेल सूची बनाएं. ऐसा करने के लिए, पेज के जांच करने वाले लोगों के सेक्शन में ईमेल सूची बनाएं लिंक पर क्लिक करें. ऐसा करने से, एक पॉप-अप खुलेगा जो आपकी ईमेल सूची बनाएगा.
इस पॉप-अप में, आप #39; ईमेल सूची को नाम देंगे और मैन्युअल रूप से ईमेल पते डाल सकते हैं या इस्तेमाल करने के लिए ईमेल पते की CSV फ़ाइल अपलोड कर सकते हैं. ऐसा करने के बाद, बदलाव सेव करें बटन दबाएं. आप ईमेल को उन ईमेल सूचियों पर वापस देख पाएंगे जिन्हें आपने ##39;ज़रूरत के मुताबिक, ईमेल पते जोड़ने या हटाने के लिए पहले ही बनाया है. जांच करने वाले लोगों को जोड़ने के बाद, अब टेस्टिंग के लिए रिलीज़ बनाने का समय आ गया है. पेज के सबसे ऊपर नई रिलीज़ बनाएं बटन पर क्लिक करें.
टेस्टिंग रिलीज़ बनाना
नई रिलीज़ बनाएं बटन पर क्लिक करने के बाद, आपको कई सेक्शन में जानकारी दिखेगी. पहली सुविधा ऐप्लिकेशन के लिए पूरी सुरक्षा देने की सुविधा है, जहां आप अपने ऐप्लिकेशन की साइनिंग कुंजी को मैनेज करने का तरीका चुनते हैं. डिफ़ॉल्ट विकल्प, Google को आपकी साइनिंग कुंजी मैनेज करने देता है. यह सुझाया गया विकल्प है. यह सुरक्षित है और आपकी अपलोड कुंजी खो जाने पर, आपके ऐप्लिकेशन को वापस पाने में मदद करता है.
Play ऐप साइनिंग
ऐप्लिकेशन अपलोड करना और उसे अंतिम रूप देना
अपनी साइनिंग कुंजी को मैनेज करने का तरीका चुनने के बाद, आपको अपनी रिलीज़ में अपना ऐप्लिकेशन बंडल अपलोड करने के लिए कहा जाएगा. ऐसा करने के लिए, उस app-release-bundle.aab फ़ाइल को खींचें और छोड़ें जिसे फ़ॉर्म में बबल के रूप में जनरेट किया गया है. रिलीज़ को पूरा करने के लिए, बाकी रिलीज़ की जानकारी भरें और सेव करें पर क्लिक करें. इसके बाद, रिलीज़ की समीक्षा करें पर क्लिक करें. आखिर में, अपनी रिलीज़ शुरू करने के लिए अंदरूनी जांच में रोल आउट शुरू करें बटन पर क्लिक करें. इससे आपका ऐप्लिकेशन, संगठन में काम करने वाले लोगों को उपलब्ध हो जाएगा! संगठन में काम करने वाले लोगों के लिए उपलब्ध जांच वाले पेज के जांच करने वाले लोग टैब पर जाकर, आप अपने ऐप्लिकेशन की जांच करने वाले लोगों के साथ शेयर करने के लिए, लिंक कॉपी कर सकते हैं. ऐसा करने पर, वे आपके ऐप्लिकेशन का ऐक्सेस पा सकेंगे.
5. इसे आज़माएं - ऐप्लिकेशन बनाएं
अब यह आपकी बारी है! पिछले चरण में आपने जो सीखा था उसका इस्तेमाल करके, नीचे दिए गए तरीके आज़माएं:
- Play Console में अपने PWA के लिए एक नया ऐप्लिकेशन बनाएं.
- ऐप्लिकेशन के लिए संगठन में काम करने वालों के लिए उपलब्ध जांच सेट अप करें और खुद को टेस्टर के तौर पर जोड़ें.
- अपना ऐप्लिकेशन बंडल अपलोड करें और अपने ऐप्लिकेशन के लिए टेस्टिंग रिलीज़ बनाएं.
- परीक्षण लिंक का उपयोग करके अपने Android या Chrome OS डिवाइस पर Play Store से अपना ऐप्लिकेशन इंस्टॉल करें!
6. डिजिटल एसेट लिंक
अगर आपको Play में अपने PWA की जांच करने का विकल्प मिला है, तो हो सकता है कि यह फ़ुलस्क्रीन पर न चले. यह यूआरएल #39 है, क्योंकि आपने डिजिटल एसेट लिंक फ़ाइल के ज़रिए अभी तक साइट के मालिकाना हक की पुष्टि नहीं की है. बबलबप आपके Android ऐप्लिकेशन बंडल को कॉन्फ़िगर कर सकता है और बना सकता है, लेकिन आपको अपना वेब ऐप्लिकेशन अपडेट करके लिंक पूरा करना होगा.
अपने ऐप्लिकेशन का #39; SHA-256 फ़िंगरप्रिंट पाएं
अपने PWA और डिजिटल एसेट लिंक को कॉन्फ़िगर करने के लिए, आपको उपयोगकर्ता को अपने फ़ोन पर मिलने वाले पैकेज पर हस्ताक्षर करने के लिए इस्तेमाल किए गए प्रमाणपत्र के लिए SHA-256 फ़िंगरप्रिंट की ज़रूरत होगी.
Play ऐप्लिकेशन साइनिंग की सुविधा के साथ
अगर आप अपनी रिलीज़ बनाते समय अपने ऐप्लिकेशन के लिए Play ऐप्लिकेशन साइनिंग की सुविधा सेट अप करते हैं (जिसके लिए पहले सुझाव दिया गया था), तो SHA-256 फ़िंगरप्रिंट Play Console पर मिल सकता है. याद रखें, यह प्रमाणपत्र आपके ऐप्लिकेशन को अपलोड करने के लिए इस्तेमाल किए गए प्रमाणपत्र से अलग है. फ़िंगरप्रिंट पाने के लिए, Play Console में अपने ऐप्लिकेशन में, रिलीज़->Setup->App Integrity पर जाएं. वहां, आपको #ऐप्लिकेशन साइनिंग कुंजी का प्रमाणपत्र में कई विकल्प दिखेंगे. SHA-256 सर्टिफ़िकेट फ़िंगरप्रिंट की वैल्यू कॉपी करें.
Play ऐप्लिकेशन साइनिंग की सुविधा के बिना
अगर आपने Play ऐप्लिकेशन साइनिंग की सुविधा से ऑप्ट आउट किया है, तो आखिरी ऐप्लिकेशन पर हस्ताक्षर करने के लिए इस्तेमाल की गई कुंजी वही होगी जिसका इस्तेमाल आप Play Console में ऐप्लिकेशन अपलोड करने के लिए करते हैं. फ़िंगरप्रिंट निकालने के लिए, आप Java's keytool का इस्तेमाल कर सकते हैं:
$ keytool -list -v \
-keystore <keystore-file-path> \
-alias <key-alias> \
-keypass <key-password> \
-storepass <store-password> | grep SHA256
$ SHA256: BD:92:64:B0:1A:B9:08:08:FC:FE:7F:94:B2...
इसका इस्तेमाल करने के लिए, आपको अपनी साइनिंग कुंजी के पाथ और उससे जुड़े पासवर्ड की ज़रूरत होगी. SHA256 कुंजी के हेक्साडेसिमल मान कॉपी करें.
अपनी डिजिटल एसेट लिंक फ़ाइल बनाएं
बबलअप, आपके हस्ताक्षर वाले फ़िंगरप्रिंट प्रबंधित कर सकता है'आपके लिए सही डिजिटल एसेट लिंक फ़ाइल पा सकता है और उसे जनरेट कर सकता है. बबल रैप करने के लिए फ़िंगरप्रिंट जोड़ने के लिए, अपने PWA के दौरान बनाए गए उसी डायरेक्ट्री में से, <fingerprint>
को पिछले चरण से कॉपी किए गए फ़िंगरप्रिंट से बदलें. इसके बाद, नीचे दिए गए निर्देश को चलाएं.
$ bubblewrap fingerprint add <fingerprint>
यह निर्देश, फ़िंगरप्रिंट को ऐप्लिकेशन की #39; सूची में जोड़ देगा और assetlinks.json फ़ाइल जनरेट करेगा. अपने PWA की तरह उसी ऑरिजिन पर इस फ़ाइल को .well-known डायरेक्ट्री में अपलोड करें.
7. इसे आज़माएं - डिजिटल एसेट लिंक
अब यह आपकी बारी है! पिछले चरण में आपने जो सीखा था उसका इस्तेमाल करके, नीचे दिए गए तरीके आज़माएं:
- अपने ऐप्लिकेशन का #39; SHA-256 फ़िंगरप्रिंट ढूंढें.
- अपने ऐप्लिकेशन के लिए डिजिटल एसेट लिंक फ़ाइल जनरेट करना.
- अपने PWA में डिजिटल एसेट लिंक फ़ाइल अपलोड करें.
- पुष्टि करें कि आपका डिजिटल एसेट लिंक फ़ाइल, एपीआई और जांच करने वाले ऐप्लिकेशन का इस्तेमाल करके सही तरीके से सेट अप की गई है.
8. देखें कि आप कितना जानते हैं
पूरा करने से पहले, अपनी जानकारी को जाँच लें. साथ ही, नीचे दिए गए सवालों के जवाब देकर जानें कि आपने क्या सीखा. जवाबों पर एक नज़र न डालें!
बबलप के साथ अपने Android प्रोजेक्ट को जनरेट करने के बाद, सीमा, जनरेट की गई ______ फ़ाइल को अपने वर्शन कंट्रोल सिस्टम के लिए तय करती हैं, ताकि वह ज़रूरत पड़ने पर उसे फिर से बना सकें.
जैक अपने QA टीम की मदद से, अपने PWA Android ऐप्लिकेशन की जांच कराना चाहते हैं. वह ______ अपने Android ऐप्लिकेशन बंडल को, संगठन में काम करने वालों के लिए उपलब्ध रिलीज़ ट्रैक पर टेस्ट कर रहे हैं.
Oogie Boogie' PWA Android ऐप्लिकेशन को फ़ुलस्क्रीन मोड में नहीं चलाया जा रहा है. इस समस्या को ठीक करने के लिए, उन्हें अपने ______ के लिए, SHA-256 प्रमाणपत्र वाला फ़िंगरप्रिंट मिलेगा. इसके बाद, उन्हें अपने PWA की तरह, ______ पर मौजूद डिजिटल एसेट लिंक फ़ाइल पर अपलोड करना होगा.
9. अपनी जानकारी की जांच करें - जवाब
'नॉलेज टेस्ट' टूल से जुड़े सवालों के जवाब!
- बबलप के साथ अपने Android प्रोजेक्ट को जनरेट करने के बाद, सीमा, जनरेट की गई ______ फ़ाइल को अपने वर्शन कंट्रोल सिस्टम के लिए तय करती हैं, ताकि वह ज़रूरत पड़ने पर उसे फिर से बना सकें.
- जवाब: twa-manifest.json
- सेक्शन: अपना PWA बबल करें
- जैक अपने QA टीम की मदद से, अपने PWA Android ऐप्लिकेशन की जांच कराना चाहते हैं. वह ______ अपने Android ऐप्लिकेशन बंडल को, संगठन में काम करने वालों के लिए उपलब्ध रिलीज़ ट्रैक पर टेस्ट कर रहे हैं.
- जवाब: साइन और अपलोड
- सेक्शन: Google के Play Store में अपना ऐप्लिकेशन जोड़ना
- Oogie Boogie' PWA Android ऐप्लिकेशन को फ़ुलस्क्रीन मोड में नहीं चलाया जा रहा है. इस समस्या को ठीक करने के लिए, उन्हें अपने ______ के लिए, SHA-256 प्रमाणपत्र वाला फ़िंगरप्रिंट मिलेगा. इसके बाद, उन्हें अपने PWA की तरह, ______ पर मौजूद डिजिटल एसेट लिंक फ़ाइल पर अपलोड करना होगा.
- जवाब: साइनिंग कुंजी, /.well-known/assetlinks.json
- सेक्शन: डिजिटल एसेट के लिंक
10. बधाई हो!
बधाई हो! आपने Google Play पर PWA को Google और #39;s स्टोर में जोड़ने का तरीका जान लिया है!
जब आप ऐसा करने के लिए तैयार हों, तो ये तरीके आज़माएं:
- ऐप्लिकेशन की प्रोडक्शन रिलीज़ बनाना
- अपने ऐप्लिकेशन को रिलीज़ करने के ज़्यादा विकल्पों के बारे में ज़्यादा जानें. इनमें, सिर्फ़ Chrome OS के रिलीज़ और Chrome OS के लिए, Android ऐप्लिकेशन शामिल करने वाली रिलीज़ शामिल हैं.
- अपने ऐप्लिकेशन के लिए Play Billing को सेट अप करने और इसे अपने PWA में और अपने बैकएंड में लागू करने का तरीका जानें.
कोडिंग करते रहें!