टेस्टर को ऐप्लिकेशन बंडल की रिलीज़ उपलब्ध कराना - कोडलैब (कोड बनाना सीखना)

1. खास जानकारी

इस कोडलैब में, आपको Firebase App Distribution और इसके Gradle प्लग इन का इस्तेमाल करके, जांच करने वाले लोगों को Android ऐप्लिकेशन बंडल रिलीज़ उपलब्ध कराने का तरीका बताया जाएगा. App Distribution आपको अपने ऐप्लिकेशन के रिलीज़-पूर्व वर्शन और हर रिलीज़ के लिए आमंत्रित किए जाने वाले टेस्टर को प्रबंधित करने के लिए एक मुख्य हब देता है.

आपको यह जानकारी मिलेगी

• Firebase ऐप्लिकेशन को Google Play से लिंक करने का तरीका
• अपने ऐप्लिकेशन को ऐप्लिकेशन बंडल के तौर पर पैकेज करने और बनाने का तरीका
• रिलीज़ बनाने और उसे लाइव टेस्टर के साथ शेयर करने का तरीका
• टेस्टर के तौर पर, नई रिलीज़ डाउनलोड करने और उनकी जांच करने का तरीका

आपको इन चीज़ों की ज़रूरत होगी

• Android Studio का सबसे नया वर्शन
• हस्ताक्षर की गई बंडल फ़ाइल, जिसे आपने Android Studio से जनरेट किया है
• ऐसा Google Play डेवलपर खाता जिसके आप मालिक या एडमिन हैं
• Google Play में आपका ऐप्लिकेशन, Google Play ऐप्लिकेशन के डैशबोर्ड पर सेट अप किया गया है और इसकी स्थिति यह है:
  • ऐप्लिकेशन को Google Play के किसी एक ट्रैक (इंटरनल टेस्टिंग, क्लोज़्ड टेस्टिंग, ओपन टेस्टिंग या प्रोडक्शन) पर उपलब्ध कराया गया हो.
  • Google Play पर ऐप्लिकेशन की समीक्षा पूरी हो गई है और ऐप्लिकेशन को पब्लिश कर दिया गया है. अगर ऐप्लिकेशन का स्टेटस कॉलम में इनमें से कोई एक स्टेटस दिखता है, तो आपका ऐप्लिकेशन पब्लिश कर दिया जाएगा: इंटरनल टेस्टिंग (ड्राफ़्ट की इंटरनल टेस्टिंग नहीं), क्लोज़्ड टेस्टिंग, ओपन टेस्टिंग या प्रोडक्शन.
• Firebase से नए बिल्ड के न्योते पाने के लिए टेस्टर के तौर पर इस्तेमाल किया जा सकने वाला ईमेल पता

2. Firebase प्रोजेक्ट बनाना

1. Firebase में साइन इन करें.
2. Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें. इसके बाद, अपने प्रोजेक्ट को "AppBundlesCodelab" का नाम दें. अपने Firebase प्रोजेक्ट का प्रोजेक्ट आईडी याद रखें. अगर आप प्रोजेक्ट आईडी में बदलाव नहीं करते हैं, तो Firebase आपके प्रोजेक्ट के लिए अपने-आप एक यूनीक आईडी असाइन कर देता है.
   
   
3. (ज़रूरी नहीं) निर्देश मिलने पर, Google Analytics को चालू करें.
4. बाकी चरण पूरे करें. इसके बाद, प्रोजेक्ट बनाएं पर क्लिक करें.

प्रोजेक्ट में अपना ऐप्लिकेशन बंडल जोड़ना

1. Firebase कंसोल में, ऐप्लिकेशन जोड़ें पर क्लिक करें.
   
   
2. अपने ऐप्लिकेशन को रजिस्टर करते समय, पक्का करें कि पैकेज के उसी नाम का इस्तेमाल किया गया हो जिसे आपने Google Play डेवलपर खाते में अपलोड किया है.

   ध्यान दें: Firebase ऐप्लिकेशन को Google Play डेवलपर खाते से जोड़ने के लिए, पैकेज का वही नाम होना ज़रूरी है. इसकी जानकारी अगले सेक्शन में दी गई है.

   आखिर में, ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.
3. अपने ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल (google-services.json) को अपने ऐप्लिकेशन में जोड़ने के लिए, बचे हुए चरण पूरे करें. ध्यान दें कि Android के लिए, App Distribution में आपके ऐप्लिकेशन में जोड़ने के लिए कोई Firebase SDK टूल नहीं होता.
4. कंसोल पर जारी रखें पर क्लिक करें.

Google Play से लिंक करें

1. Firebase कंसोल में, अपनी प्रोजेक्ट सेटिंग पर जाएं.
   
   
2. इंटिग्रेशन टैब में, Google Play कार्ड पर लिंक करें पर क्लिक करें.
3. App Distribution इंटिग्रेशन को चालू करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें. इसके बाद, Google Play से लिंक करने के लिए, नया Firebase ऐप्लिकेशन चुनें.

अब आपने इन चरणों को पूरा कर लिया है, इसलिए आपका Firebase ऐप्लिकेशन आपके Google Play डेवलपर खाते में मौजूद ऐप्लिकेशन से तब तक लिंक रहेगा, जब तक ऐप्लिकेशन पैकेज नाम मेल खाते हैं.

3. अपने प्रोजेक्ट में App Distribution जोड़ना

App Distribution Gradle प्लग इन जोड़ना

अब अपने ऐप्लिकेशन में App Distribution और उसका Gradle प्लग इन जोड़ने के लिए, Android Studio का इस्तेमाल किया जा सकेगा.

1. अपनी प्रोजेक्ट-लेवल की Gradle फ़ाइल (android/build.gradle.kts) में, plugins ब्लॉक में App Distribution Gradle प्लग इन जोड़ें.

   plugins {
        //...
   
        // Add the App Distribution Gradle plugin
        id("com.google.firebase.appdistribution") version "4.0.0" apply false
   }
   

2. प्रोजेक्ट-लेवल की सेटिंग Gradle फ़ाइल (android/settings.gradle.kts) में, pluginManagement ब्लॉक में Google की Maven रिपॉज़िटरी जोड़ें.

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. अपनी ऐप्लिकेशन-लेवल की Gradle फ़ाइल (android/app/build.gradle.kts) में, plugins ब्लॉक में App Distribution प्लग इन जोड़ें.

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. अगर किसी कॉर्पोरेट प्रॉक्सी या फ़ायरवॉल का इस्तेमाल किया जा रहा है, तो यहां दी गई Java सिस्टम प्रॉपर्टी जोड़ें. इसकी मदद से, App Distribution की मदद से आपके डिस्ट्रिब्यूशन को Firebase पर अपलोड किया जा सकता है:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

अपने Firebase प्रोजेक्ट की पुष्टि करना

Gradle प्लग इन का इस्तेमाल करने से पहले, आपको अपने Firebase प्रोजेक्ट की पुष्टि करनी होगी. इस कोडलैब के लिए, आपको Firebase सीएलआई का इस्तेमाल करके अपने Google खाते में साइन इन करना होगा.

अपने Android प्रोजेक्ट के रूट में यहां दिया गया कमांड चलाएं:

~/your-android-project$ firebase login

पहचान फ़ाइल में ज़्यादा जानकारी मौजूद है.

4. Android Studio में अपनी बंडल प्रॉपर्टी कॉन्फ़िगर करना

इस चरण में, आपको उस बिल्ड के टेस्टर के तौर पर खुद को जोड़ना होगा जिसे बाद में डिस्ट्रिब्यूट किया जाएगा. बिल्ड डिस्ट्रिब्यूट करने के बाद, टेस्टर को Firebase से ईमेल सूचनाएं मिलती हैं. इन सूचनाओं में, उन्हें नए बिल्ड की जांच करने का न्योता दिया जाता है.

अपने app/build.gradle.kts में, firebaseAppDistribution सेक्शन जोड़ें और इसमें ये पैरामीटर शामिल करें:

• appID: आपके ऐप्लिकेशन का Firebase ऐप्लिकेशन आईडी. यह आपको प्रोजेक्ट सेटिंग के सामान्य टैब में दिखेगा.
• artifactType: आपके ऐप्लिकेशन का फ़ाइल टाइप (AAB).
• testers: आपके ऐप्लिकेशन की जांच करने वाले लोगों की ईमेल पते. इस कोडलैब के लिए, अपना ईमेल पता जोड़ें, ताकि बिल्ड के डिस्ट्रिब्यूट होने के बाद उसकी जांच की जा सके.

उदाहरण के लिए:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

एक विकल्प के तौर पर, -PappDistribution-property-name=property-value के तौर पर कमांड लाइन आर्ग्युमेंट पास करके, build.gradle.kts में सेट की गई वैल्यू को बदला भी जा सकता है.

5. कोई रिलीज़ बनाएं और उसे डिस्ट्रिब्यूट करें

1. ऐप्लिकेशन बंडल फ़ाइल बनाने के लिए, bundleVariant Gradle टास्क चलाएं:

   $ ./gradlew :base:bundleRelease
   

2. अपने ऐप्लिकेशन की बिल्ड डायरेक्ट्री में बंडल ढूंढें (डिफ़ॉल्ट जगह app/build/outputs/bundle/release है).
3. रिलीज़ को डिस्ट्रिब्यूट करने के लिए, अपने प्रोजेक्ट के Gradle रैपर की मदद से, bundleRelease और appDistributionUploadRelease टारगेट बनाएं. Firebase टोकन शामिल करें. तीसरे चरण में मिला टोकन: अपने ऐप्लिकेशन में App Distribution जोड़ें.

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

टेस्टर को अब बिल्ड को डाउनलोड करने और टेस्ट करने के लिए ईमेल के न्योते मिलेंगे. डेवलपर के तौर पर, अब आप App Distribution डैशबोर्ड के रिलीज़ टैब में बिल्ड पर नज़र रख सकते हैं.

6. अपनी रिलीज़ डाउनलोड करना और उसकी जांच करना

इस सेक्शन में, डिस्ट्रिब्यूट की गई रिलीज़ को डाउनलोड करने के लिए, आपको टेस्टर के तौर पर सेट अप करना होगा. टेस्टर के तौर पर, आपको अपने टेस्ट डिवाइस की पुष्टि करनी होगी. साथ ही, Google Play Store ऐप्लिकेशन में, संगठन में काम करने वालों के साथ ऐप्लिकेशन शेयर करने की सुविधा चालू करनी होगी.

1. अपने टेस्ट डिवाइस पर, टेस्टर के ईमेल खाते में साइन इन करें और Firebase से मिला न्योता खोलें.
   
   
2. अपने Google खाते से साइन इन करें और उपलब्ध कराई गई रिलीज़ की जांच करने का न्योता स्वीकार करें. विकल्प के तौर पर, Firebase ऐप्लिकेशन टेस्टर भी डाउनलोड किया जा सकता है. इससे, डाउनलोड की गई रिलीज़ आपके डिवाइस के Downloads फ़ोल्डर में नहीं जोड़ी जा सकेंगी. इसमें रिलीज़ के बारे में अन्य जानकारी भी दिखती है. जैसे, डाउनलोड की प्रोग्रेस और रिलीज़ वर्शन की जानकारी.
   
   
3. रिलीज़ में से डाउनलोड करें पर टैप करके, उसे Play Store से इंस्टॉल करें.
4. जब कहा जाए, तब संगठन में काम करने वालों के साथ ऐप्लिकेशन शेयर करने की सुविधा चालू करने के लिए, बाकी चरणों को पूरा करें. ये निर्देश आपके टेस्ट डिवाइस पर दिखते हैं और इन्हें सिर्फ़ एक बार पूरा करना होगा.

डाउनलोड पूरा होने के बाद, आपकी रिलीज़ आपके डिवाइस की होम स्क्रीन पर शॉर्टकट के तौर पर अपने-आप दिखेगी.

7. बधाई हो!

आपने अभी-अभी ऐप्लिकेशन बंडल अपलोड करने और जांच करने वाले लोगों को रिलीज़ बांटने के लिए, Firebase App Distribution का इस्तेमाल किया है.

अगले चरण

• अपनी रिलीज़ के लिए, टेस्टर को मैनेज करने के तरीके के बारे में ज़्यादा जानने के लिए, App Distribution दस्तावेज़ देखें.
• अपने ऐप्लिकेशन को डिप्लॉय करने के लिए जो दूसरे टूल इस्तेमाल किए जा सकते हैं उनके बारे में जानने के लिए, अपना 'Android ऐप्लिकेशन बंडल' बनाएं और उसकी जांच करें लेख पढ़ें.