भरोसेमंद वेब गतिविधियों को सेट अप करना थोड़ा मुश्किल हो सकता है. खास तौर पर, तब जब आपको सिर्फ़ अपनी वेबसाइट दिखानी हो. इस गाइड में, भरोसेमंद वेब गतिविधियों का इस्तेमाल करने वाले बुनियादी प्रोजेक्ट बनाने के बारे में बताया गया है. इसमें, इस प्रोजेक्ट से जुड़ी सभी बातों के बारे में बताया गया है.
इस गाइड को पढ़ने के बाद, आपको ये चीज़ें पता होंगी:
- आपने Bubblewrap का इस्तेमाल करके, भरोसेमंद वेब गतिविधि का इस्तेमाल करने वाला और पुष्टि की प्रक्रिया पूरी करने वाला ऐप्लिकेशन बनाया हो.
- यह जानना कि हस्ताक्षर करने के लिए इस्तेमाल की जाने वाली कुंजियों का इस्तेमाल कब किया जाता है.
- यह पता लगाने में सक्षम होना चाहिए कि आपके Android ऐप्लिकेशन को किस हस्ताक्षर के साथ बनाया जा रहा है.
- डिजिटल ऐसेट के लिंक वाली बुनियादी फ़ाइल बनाने का तरीका जानें.
इस गाइड का पालन करने के लिए, आपके पास ये चीज़ें होनी चाहिए:
- डेवलपमेंट कंप्यूटर पर Node.js 10 या उसके बाद का वर्शन इंस्टॉल होना चाहिए
- डेवलपमेंट के लिए कनेक्ट और सेट अप किया गया Android फ़ोन या एमुलेटर (अगर फ़िज़िकल फ़ोन का इस्तेमाल किया जा रहा है, तो यूएसबी डीबगिंग चालू करें)
- आपके डेवलपमेंट फ़ोन पर, भरोसेमंद वेब गतिविधि की सुविधा के साथ काम करने वाला ब्राउज़र
- वह वेबसाइट जिसे आप भरोसेमंद वेब गतिविधि में देखना चाहते हैं
भरोसेमंद वेब गतिविधि की मदद से, आपके Android ऐप्लिकेशन को बिना किसी ब्राउज़र यूज़र इंटरफ़ेस (यूआई) के फ़ुल स्क्रीन ब्राउज़र टैब लॉन्च करने की अनुमति मिलती है. यह सुविधा सिर्फ़ उन वेबसाइटों के लिए उपलब्ध है जिनका मालिकाना हक आपके पास है. डिजिटल एसेट लिंक सेट अप करके, इस बात की पुष्टि की जा सकती है. हम उनके बारे में बाद में ज़्यादा बात करेंगे.
भरोसेमंद वेब गतिविधि लॉन्च करने पर, ब्राउज़र यह जांच करेगा कि डिजिटल एसेट लिंक सही हैं या नहीं. इसे पुष्टि कहा जाता है. अगर पुष्टि नहीं हो पाती है, तो ब्राउज़र आपकी वेबसाइट को कस्टम टैब के तौर पर दिखाएगा.
Bubblewrap को इंस्टॉल और कॉन्फ़िगर करना
Bubblewrap, Node.js के लिए लाइब्रेरी और कमांड-लाइन टूल (सीएलआई) का एक सेट है. इसकी मदद से, डेवलपर Android ऐप्लिकेशन में भरोसेमंद वेब गतिविधि का इस्तेमाल करके, प्रोग्रेसिव वेब ऐप्लिकेशन जनरेट, बनाए, और चला सकते हैं.
CLI को इस निर्देश की मदद से इंस्टॉल किया जा सकता है:
एनवायरमेंट सेट अप करना
Bubblewrap को पहली बार चलाने पर, यह ज़रूरी बाहरी डिपेंडेंसी को अपने-आप डाउनलोड और इंस्टॉल करने का विकल्प देगा. हमारा सुझाव है कि टूल को ऐसा करने दें, क्योंकि इससे यह पक्का हो जाता है कि डिपेंडेंसी सही तरीके से कॉन्फ़िगर की गई हैं. किसी मौजूदा Java Development Kit (JDK) या Android कमांड-लाइन टूल इंस्टॉलेशन का इस्तेमाल करने के लिए, Bubblewrap दस्तावेज़ देखें.
प्रोजेक्ट शुरू करना और बनाना
PWA को रैप करने वाले Android प्रोजेक्ट को शुरू करने के लिए, init कमांड चलाएं:
Bubblewrap, वेब मेनिफ़ेस्ट को पढ़ेगा. साथ ही, डेवलपर से Android प्रोजेक्ट में इस्तेमाल की जाने वाली वैल्यू की पुष्टि करने के लिए कहेगा. इसके बाद, उन वैल्यू का इस्तेमाल करके प्रोजेक्ट जनरेट करेगा. प्रोजेक्ट जनरेट होने के बाद, यह कमांड चलाकर APK जनरेट करें:
चलाएं
बिल्ड करने की प्रोसेस के आउटपुट में, app-release-signed.apk
नाम की एक फ़ाइल होगी. इस फ़ाइल को टेस्टिंग के लिए डेवलपमेंट डिवाइस पर इंस्टॉल किया जा सकता है या रिलीज़ के लिए Play Store पर अपलोड किया जा सकता है.
Bubblewrap, किसी स्थानीय डिवाइस पर ऐप्लिकेशन को इंस्टॉल और टेस्ट करने के लिए निर्देश देता है. कंप्यूटर से कनेक्ट किए गए डेवलपमेंट डिवाइस पर, यह तरीका अपनाएं:
इसके अलावा, adb टूल का इस्तेमाल भी किया जा सकता है.
ध्यान दें: **adb**
कमांड-लाइन टूल, **android_sdk/platform-tools/**
में मौजूद Android कमांड-लाइन टूल में होता है.
यह ऐप्लिकेशन अब डिवाइस के लॉन्चर पर उपलब्ध है. ऐप्लिकेशन खोलने पर, आपको पता चलेगा कि आपकी वेबसाइट, भरोसेमंद वेब गतिविधि के तौर पर नहीं, बल्कि कस्टम टैब के तौर पर लॉन्च हुई है. ऐसा इसलिए है, क्योंकि हमने अब तक डिजिटल एसेट के लिंक की पुष्टि करने की सुविधा सेट अप नहीं की है. हालांकि, पहले...
Bubblewrap के लिए ग्राफ़िकल यूज़र इंटरफ़ेस (जीयूआई) के विकल्प
PWA बिल्डर, जीयूआई इंटरफ़ेस उपलब्ध कराता है. यह बबल रैप लाइब्रेरी का इस्तेमाल करके, भरोसेमंद वेब गतिविधि वाले प्रोजेक्ट जनरेट करता है. इस ब्लॉग पोस्ट में, PWA Builder का इस्तेमाल करके ऐसा Android ऐप्लिकेशन बनाने के बारे में ज़्यादा जानें जो आपके PWA को खोलता है.
साइनिंग पासकोड के बारे में जानकारी
डिजिटल एसेट लिंक, उस कुंजी को ध्यान में रखते हैं जिससे APK को साइन किया गया है. पुष्टि न हो पाने की एक आम वजह, गलत हस्ताक्षर का इस्तेमाल करना है. (याद रखें, पुष्टि न होने का मतलब है कि आपको अपनी वेबसाइट, पेज के सबसे ऊपर ब्राउज़र यूज़र इंटरफ़ेस (यूआई) के साथ एक कस्टम टैब के रूप में लॉन्च करनी होगी.) जब Bubblewrap ऐप्लिकेशन बनाता है, तो init
चरण के दौरान कुंजी सेट अप करके एक APK बनाया जाता है. हालांकि, जब Google Play पर अपना ऐप्लिकेशन पब्लिश किया जाता है, तो आपके लिए एक और पासकोड बनाया जा सकता है. यह इस बात पर निर्भर करता है कि आपने साइनिंग पासकोड को कैसे मैनेज किया है. कुंजियों पर हस्ताक्षर करने और इस बारे में ज़्यादा जानें कि ये Bubblewrap और Google Play से कैसे जुड़े हैं.
ऐसेट लिंक फ़ाइल सेट अप करना
डिजिटल एसेट लिंक में, आपकी वेबसाइट पर मौजूद एक फ़ाइल होती है जो आपके ऐप्लिकेशन पर ले जाती है. साथ ही, आपके ऐप्लिकेशन में कुछ मेटाडेटा होता है जो आपकी वेबसाइट पर ले जाता है.
assetlinks.json
फ़ाइल बनाने के बाद, उसे अपनी वेबसाइट पर अपलोड करें .well-known/assetlinks.json
) को रूट के मुताबिक बनाया जाता है, ताकि ब्राउज़र आपके ऐप्लिकेशन की सही तरीके से पुष्टि कर सके. यह आपके साइनिंग पासकोड से कैसे जुड़ा है, इस बारे में ज़्यादा जानकारी के लिए, डिजिटल ऐसेट लिंक के बारे में पूरी जानकारी देखें.
आपके ब्राउज़र की जांच करना
भरोसेमंद वेब गतिविधि, उपयोगकर्ता के डिफ़ॉल्ट ब्राउज़र विकल्प के मुताबिक काम करने की कोशिश करेगी. अगर उपयोगकर्ता का डिफ़ॉल्ट ब्राउज़र, भरोसेमंद वेब गतिविधियों के साथ काम करता है, तो उसे लॉन्च कर दिया जाएगा. ऐसा न होने पर, अगर इंस्टॉल किया गया कोई भी ब्राउज़र भरोसेमंद वेब गतिविधियों पर काम करता है, तो उसे चुन लिया जाएगा. आखिर में, 'कस्टम टैब' मोड को डिफ़ॉल्ट तौर पर सेट किया जाता है.
इसका मतलब है कि अगर भरोसेमंद वेब गतिविधियों से जुड़ी किसी चीज़ को डीबग किया जा रहा है, तो आपको यह पक्का करना चाहिए कि आपने जिस ब्राउज़र का इस्तेमाल किया है वह वही है जिसका आपको इस्तेमाल करना है. यह देखने के लिए कि कौनसा ब्राउज़र इस्तेमाल किया जा रहा है, इस निर्देश का इस्तेमाल करें:
अगले चरण
उम्मीद है कि इस गाइड का पालन करने पर, आपके पास भरोसेमंद वेब गतिविधि की सुविधा काम कर रही होगी. साथ ही, पुष्टि न होने पर, आपको यह जानने के लिए ज़रूरी जानकारी भी मिल जाएगी कि क्या हो रहा है. अगर नहीं, तो वेब डेवलपर के लिए Android के कॉन्सेप्ट के बारे में ज़्यादा जानें या इन दस्तावेज़ों के ख़िलाफ़ GitHub पर समस्या दर्ज करें.
हमारा सुझाव है कि आप अपने ऐप्लिकेशन के लिए आइकॉन बनाएं. इसके बाद, अपने ऐप्लिकेशन को Play Store पर डिप्लॉय करें.