भरोसेमंद वेब गतिविधियों को सेट अप करना थोड़ा मुश्किल हो सकता है. खास तौर पर, जब आपको सिर्फ़ अपनी वेबसाइट दिखानी हो. इस गाइड में, आपको एक ऐसा बेसिक प्रोजेक्ट बनाने का तरीका बताया गया है जो भरोसेमंद वेब गतिविधियों का इस्तेमाल करता है. इसमें सभी गॉचा शामिल हैं.
इस गाइड के आखिर में, आपको ये काम करने होंगे:
- आपने Bubblewrap का इस्तेमाल करके, ऐसा ऐप्लिकेशन बनाया हो जो भरोसेमंद वेब गतिविधि का इस्तेमाल करता हो और जिसकी पुष्टि हो चुकी हो.
- यह जानना कि हस्ताक्षर करने के लिए इस्तेमाल की जाने वाली कुंजियों का इस्तेमाल कब किया जाता है.
- यह पता लगाने में सक्षम होना चाहिए कि आपके Android ऐप्लिकेशन को किस हस्ताक्षर के साथ बनाया जा रहा है.
- डिजिटल ऐसेट के लिंक वाली बुनियादी फ़ाइल बनाने का तरीका जानें.
इस गाइड का पालन करने के लिए, आपके पास ये चीज़ें होनी चाहिए:
- डेवलपमेंट कंप्यूटर पर Node.js या इसके बाद का वर्शन इंस्टॉल होना चाहिए.
- डेवलपमेंट के लिए कनेक्ट और सेट अप किया गया Android फ़ोन या एमुलेटर (अगर किसी फ़िज़िकल फ़ोन का इस्तेमाल किया जा रहा है, तो यूएसबी डीबगिंग चालू करें).
- ऐसा ब्राउज़र जो आपके डेवलपमेंट फ़ोन पर, भरोसेमंद वेब गतिविधि की सुविधा के साथ काम करता हो. Chrome 72 या उसके बाद का वर्शन काम करेगा. अन्य ब्राउज़र में समर्थन आने वाला है.
- वह वेबसाइट जिसे आपको 'भरोसेमंद वेब गतिविधि' में देखना है.
भरोसेमंद वेब गतिविधि की मदद से, आपके Android ऐप्लिकेशन को किसी भी ब्राउज़र यूज़र इंटरफ़ेस के बिना, फ़ुल स्क्रीन ब्राउज़र टैब लॉन्च करने की अनुमति मिलती है. यह सुविधा सिर्फ़ उन वेबसाइटों के लिए उपलब्ध है जिनका मालिकाना हक आपके पास है. डिजिटल एसेट लिंक सेट अप करके, इसकी पुष्टि की जा सकती है. हम उनके बारे में बाद में ज़्यादा बात करेंगे.
भरोसेमंद वेब गतिविधि लॉन्च करने पर, ब्राउज़र यह जांच करेगा कि डिजिटल एसेट लिंक की पुष्टि की गई है या नहीं. इसे पुष्टि कहा जाता है. अगर पुष्टि नहीं हो पाती है, तो ब्राउज़र आपकी वेबसाइट को कस्टम टैब के तौर पर दिखाएगा.
Bubblewrap को इंस्टॉल और कॉन्फ़िगर करना
Bubblewrap, लाइब्रेरी का सेट और Node.js के लिए एक कमांड लाइन टूल (सीएलआई) है. यह भरोसेमंद वेब गतिविधि का इस्तेमाल करके, Android ऐप्लिकेशन के अंदर प्रोग्रेसिव वेब ऐप्लिकेशन बनाने, बनाने, और चलाने में डेवलपर की मदद करता है.
CLI को इस निर्देश की मदद से इंस्टॉल किया जा सकता है:
npm i -g @bubblewrap/cli
एनवायरमेंट सेट अप करना
Bubblewrap को पहली बार चलाने पर, यह ज़रूरी बाहरी डिपेंडेंसी को अपने-आप डाउनलोड और इंस्टॉल करने का विकल्प देगा. हमारा सुझाव है कि आप टूल को ऐसा करने की अनुमति दें, क्योंकि इससे यह पक्का होता है कि डिपेंडेंसी सही तरीके से कॉन्फ़िगर की गई हैं. मौजूदा Java Development Kit (JDK) या Android कमांड-लाइन टूल इंस्टॉलेशन का इस्तेमाल करने के लिए, Bubblewrap दस्तावेज़ देखें.
प्रोजेक्ट को शुरू और बिल्ड करना
PWA को रैप करने वाले Android प्रोजेक्ट को शुरू करने के लिए, init कमांड चलाएं:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Bubblewrap, वेब मेनिफ़ेस्ट को पढ़ेगा और डेवलपर से Android प्रोजेक्ट में इस्तेमाल की जाने वाली वैल्यू की पुष्टि करने के लिए कहेगा. साथ ही, उन वैल्यू का इस्तेमाल करके प्रोजेक्ट जनरेट करेगा. प्रोजेक्ट जनरेट होने के बाद, इसे चलाकर APK जनरेट करें:
bubblewrap build
चलाएं
बिल्ड करने की प्रोसेस के आउटपुट में, app-release-signed.apk नाम की एक फ़ाइल होगी. इस फ़ाइल को जांच के लिए, डेवलपमेंट डिवाइस पर इंस्टॉल किया जा सकता है या रिलीज़ के लिए Play Store पर अपलोड किया जा सकता है.
Bubblewrap, लोकल डिवाइस पर ऐप्लिकेशन को इंस्टॉल और टेस्ट करने के लिए निर्देश देता है. कंप्यूटर से कनेक्ट किए गए डिवाइस पर, ये काम करें:
bubblewrap install
इसके अलावा, adb टूल का इस्तेमाल भी किया जा सकता है.
adb install app-release-signed.apk
अब ऐप्लिकेशन, डिवाइस के लॉन्चर पर उपलब्ध हो जाएगा. ऐप्लिकेशन खोलते समय आप देखेंगे कि आपकी वेबसाइट को एक कस्टम टैब के रूप में लॉन्च किया गया है, न कि एक विश्वसनीय वेब गतिविधि के रूप में, ऐसा इसलिए है क्योंकि हमने अभी तक अपना डिजिटल एसेट लिंक सत्यापन सेट नहीं किया है, लेकिन पहले...
बबल रैप के लिए ग्राफ़िकल यूज़र इंटरफ़ेस (जीयूआई) विकल्प
PWA Builder, एक ऐसा जीयूआई इंटरफ़ेस उपलब्ध कराता है जो भरोसेमंद वेब गतिविधि प्रोजेक्ट जनरेट करने के लिए, Bubblewrap लाइब्रेरी का इस्तेमाल करता है. इस ब्लॉग पोस्ट में, ऐसा Android ऐप्लिकेशन बनाने के लिए PWA बिल्डर का इस्तेमाल करने के बारे में ज़्यादा जानें जिससे आपका PWA खुलता है.
साइनिंग पासकोड के बारे में जानकारी
डिजिटल एसेट लिंक, उस कुंजी को ध्यान में रखते हैं जिससे APK को साइन किया गया है. पुष्टि न हो पाने की एक आम वजह, गलत हस्ताक्षर का इस्तेमाल करना है. (याद रखें, पुष्टि न होने का मतलब है कि आपको अपनी वेबसाइट, पेज के सबसे ऊपर ब्राउज़र यूज़र इंटरफ़ेस (यूआई) के साथ एक कस्टम टैब के रूप में लॉन्च करनी होगी.) जब Bubblewrap ऐप्लिकेशन बनाता है, तो init चरण के दौरान कुंजी सेट अप करके एक APK बनाया जाता है. हालांकि, Google Play में अपना ऐप्लिकेशन पब्लिश करने पर, आपके लिए एक और पासकोड बनाया जा सकता है. यह इस बात पर निर्भर करता है कि आपने साइनिंग पासकोड मैनेज करने का कौनसा तरीका चुना है. साइनिंग पासकोड और इनका Bubblewrap और Google Play से जुड़ाव के बारे में ज़्यादा जानें.
ऐसेट लिंक फ़ाइल सेट अप की जा रही है
डिजिटल एसेट लिंक में, आपकी वेबसाइट पर मौजूद एक फ़ाइल होती है जो आपके ऐप्लिकेशन पर ले जाती है. साथ ही, आपके ऐप्लिकेशन में कुछ ऐसा मेटाडेटा होता है जो आपकी वेबसाइट पर ले जाता है.
assetlinks.json फ़ाइल बनाने के बाद, उसे अपनी वेबसाइट पर .well-known/assetlinks.json पर अपलोड करें. यह वेबसाइट के रूट से जुड़ा होना चाहिए, ताकि ब्राउज़र आपके ऐप्लिकेशन की पुष्टि सही तरीके से कर सके. यह आपके साइनिंग पासकोड से कैसे जुड़ा है, इस बारे में ज़्यादा जानकारी के लिए, डिजिटल ऐसेट लिंक के बारे में पूरी जानकारी देखें.
आपके ब्राउज़र की जांच करना
भरोसेमंद वेब गतिविधि, उपयोगकर्ता के डिफ़ॉल्ट ब्राउज़र का इस्तेमाल करने की कोशिश करेगी. अगर उपयोगकर्ता का डिफ़ॉल्ट ब्राउज़र, भरोसेमंद वेब गतिविधियों के साथ काम करता है, तो उसे लॉन्च कर दिया जाएगा. अगर ऐसा नहीं होता है, तो अगर कोई इंस्टॉल किया गया ब्राउज़र, भरोसेमंद वेब गतिविधियों के साथ काम करता है, तो उसे चुना जाएगा. आखिर में, डिफ़ॉल्ट रूप से कस्टम टैब मोड पर वापस आ जाता है.
इसका मतलब है कि अगर भरोसेमंद वेब गतिविधियों से जुड़ी किसी चीज़ को डीबग किया जा रहा है, तो आपको यह पक्का करना चाहिए कि आप उसी ब्राउज़र का इस्तेमाल कर रहे हैं जिसका आपको लगता है कि आप कर रहे हैं. यह देखने के लिए कि कौनसा ब्राउज़र इस्तेमाल किया जा रहा है, इस निर्देश का इस्तेमाल करें:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
अगले चरण
उम्मीद है कि इस गाइड का पालन करने पर, आपके पास भरोसेमंद वेब गतिविधि की सुविधा काम करेगी. साथ ही, पुष्टि न होने पर, आपको इस बारे में डीबग करने के लिए ज़रूरी जानकारी भी मिलेगी. अगर नहीं, तो वेब डेवलपर के लिए Android के कॉन्सेप्ट के बारे में ज़्यादा जानें या इन दस्तावेज़ों के ख़िलाफ़ GitHub पर समस्या दर्ज करें.
हमारा सुझाव है कि अगले चरण के लिए, आप अपने ऐप्लिकेशन के लिए आइकॉन बनाएं. इसके बाद, अपने ऐप्लिकेशन को Play Store पर डिप्लॉय करें.