परीक्षकों को ऐप बंडल रिलीज़ वितरित करें - कोडेलैब

1 अवलोकन

image10.png

इस कोडलैब में, आप सीखेंगे कि फायरबेस ऐप डिस्ट्रीब्यूशन और इसके ग्रैडल प्लगइन का उपयोग करके परीक्षकों को एंड्रॉइड ऐप बंडल रिलीज़ कैसे वितरित करें। ऐप डिस्ट्रीब्यूशन आपके ऐप के प्री-रिलीज़ संस्करणों और प्रत्येक रिलीज़ के लिए आपके द्वारा आमंत्रित परीक्षकों को प्रबंधित करने के लिए एक केंद्रीय केंद्र प्रदान करता है।

आप क्या सीखेंगे

  • अपने फायरबेस ऐप को Google Play से कैसे लिंक करें
  • अपने ऐप को ऐप बंडल के रूप में कैसे पैकेज करें और बनाएं
  • एक रिलीज़ कैसे बनाएं और उसे लाइव परीक्षकों के साथ कैसे साझा करें
  • एक परीक्षक के रूप में नई रिलीज़ को कैसे डाउनलोड और परीक्षण करें

आपको किस चीज़ की ज़रूरत पड़ेगी

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

2. एक फायरबेस प्रोजेक्ट बनाएं

  1. फायरबेस में साइन इन करें।
  2. फायरबेस कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें, फिर अपने प्रोजेक्ट को "AppBundlesCodelab" नाम दें। अपने फायरबेस प्रोजेक्ट के लिए प्रोजेक्ट आईडी याद रखें। यदि आप प्रोजेक्ट आईडी को संपादित नहीं करते हैं, तो फायरबेस स्वचालित रूप से आपके प्रोजेक्ट के लिए एक अद्वितीय आईडी निर्दिष्ट करता है।

    image8.png
  3. (वैकल्पिक) संकेत मिलने पर, Google Analytics सक्षम करें।
  4. शेष चरण पूरे करें, फिर प्रोजेक्ट बनाएं पर क्लिक करें।

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

  1. फायरबेस कंसोल में, ऐप जोड़ें पर क्लिक करें।

    image5.png
  2. अपना ऐप पंजीकृत करते समय, सुनिश्चित करें कि आप उसी पैकेज नाम का उपयोग करें जो ऐप आपके Google Play डेवलपर खाते पर अपलोड किया गया है। अंत में, रजिस्टर ऐप पर क्लिक करें।
  3. अपने ऐप की फायरबेस कॉन्फ़िगरेशन फ़ाइल ( google-services.json ) को अपने ऐप में जोड़ने के लिए शेष चरणों को पूरा करें। ध्यान दें कि एंड्रॉइड के लिए, ऐप डिस्ट्रीब्यूशन में आपके ऐप में जोड़ने के लिए फायरबेस एसडीके नहीं है।
  4. कंसोल करने के लिए जारी रखें पर क्लिक करें।
  1. फायरबेस कंसोल में, अपनी प्रोजेक्ट सेटिंग्स पर जाएं।

    image2.png
  2. एकीकरण टैब में, Google Play कार्ड पर लिंक पर क्लिक करें।
  3. ऐप वितरण एकीकरण को सक्षम करने के लिए ऑन-स्क्रीन निर्देशों का पालन करें, फिर Google Play से लिंक करने के लिए अपने नए बनाए गए फायरबेस ऐप का चयन करें।

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

3. अपने प्रोजेक्ट में ऐप वितरण जोड़ें

ऐप डिस्ट्रीब्यूशन ग्रैडल प्लगइन जोड़ें

अब, आप अपने ऐप में ऐप डिस्ट्रीब्यूशन और इसके ग्रैडल प्लगइन को जोड़ने के लिए एंड्रॉइड स्टूडियो का उपयोग करेंगे।

  1. अपने प्रोजेक्ट-स्तरीय ग्रैडल फ़ाइल ( android/build.gradle.kts ) में, ऐप डिस्ट्रीब्यूशन ग्रैडल प्लगइन को plugins ब्लॉक में जोड़ें।
    plugins {
         //...
    
         // Add the App Distribution Gradle plugin
         id("com.google.firebase.appdistribution") version "4.0.0" apply false
    }
    
  2. अपने प्रोजेक्ट-स्तरीय सेटिंग्स ग्रैडल फ़ाइल ( android/settings.gradle.kts ) में, pluginManagement ब्लॉक में Google की मावेन रिपॉजिटरी जोड़ें।
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. अपनी ऐप-स्तरीय ग्रैडल फ़ाइल ( android/app/build.gradle.kts ) में, ऐप डिस्ट्रीब्यूशन प्लगइन को plugins ब्लॉक में जोड़ें।
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. यदि आप कॉर्पोरेट प्रॉक्सी या फ़ायरवॉल के पीछे हैं, तो निम्नलिखित जावा सिस्टम प्रॉपर्टी जोड़ें जो ऐप डिस्ट्रीब्यूशन को आपके वितरण को फ़ायरबेस पर अपलोड करने में सक्षम बनाता है:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

अपने फायरबेस प्रोजेक्ट को प्रमाणित करें

इससे पहले कि आप ग्रैडल प्लगइन का उपयोग कर सकें, आपको अपने फायरबेस प्रोजेक्ट को प्रमाणित करना होगा। इस कोडलैब के लिए, आप फायरबेस सीएलआई का उपयोग करके अपने Google खाते में साइन इन करेंगे।

अपने Android प्रोजेक्ट के रूट पर निम्नलिखित कमांड चलाएँ:

~/your-android-project$ firebase login

संदर्भ दस्तावेज़ में अधिक विवरण हैं।

4. एंड्रॉइड स्टूडियो में अपने बंडल गुणों को कॉन्फ़िगर करें

इस चरण में, आप स्वयं को उस बिल्ड के लिए एक परीक्षक के रूप में जोड़ेंगे जिसे आप बाद में वितरित करेंगे। एक बार जब आप बिल्ड वितरित कर देते हैं, तो परीक्षकों को फायरबेस से ईमेल सूचनाएं प्राप्त होती हैं जो उन्हें नए बिल्ड का परीक्षण करने के लिए आमंत्रित करती हैं।

अपने app/build.gradle.kts में, एक firebaseAppDistribution अनुभाग जोड़ें और निम्नलिखित पैरामीटर शामिल करें:

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

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

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

एक विकल्प के रूप में, आप -PappDistribution- property-name = property-value के रूप में कमांड लाइन तर्क पारित करके अपने build.gradle.kts में निर्धारित मानों को ओवरराइड भी कर सकते हैं।

5. एक रिलीज बनाएं और वितरित करें

  1. अपनी ऐप बंडल फ़ाइल बनाने के लिए bundle Variant ग्रैडल कार्य चलाएँ:
    $ ./gradlew :base:bundleRelease
    
  2. अपने एप्लिकेशन की बिल्ड निर्देशिका में बंडल का पता लगाएं (डिफ़ॉल्ट स्थान app/build/outputs/bundle/release है)।
  3. रिलीज़ को वितरित करने के लिए, अपने प्रोजेक्ट के ग्रैडल रैपर के साथ लक्ष्य bundleRelease और appDistributionUploadRelease बनाएं। फ़ायरबेस टोकन शामिल करें (जो आपको चरण 3 में प्राप्त हुआ था: अपने ऐप में ऐप वितरण जोड़ें)।
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

परीक्षकों को अब बिल्ड को डाउनलोड करने और परीक्षण करने के लिए ईमेल आमंत्रण प्राप्त होंगे। डेवलपर के रूप में, अब आप ऐप वितरण डैशबोर्ड के रिलीज़ टैब में बिल्ड की निगरानी कर सकते हैं।

6. अपनी रिलीज़ को डाउनलोड करें और उसका परीक्षण करें

इस अनुभाग में, आपके द्वारा वितरित रिलीज़ को डाउनलोड करने के लिए आपको एक परीक्षक के रूप में स्थापित किया जाएगा। एक परीक्षक के रूप में, आपको अपने परीक्षण उपकरण को प्रमाणित करना होगा और Google Play Store ऐप में आंतरिक ऐप साझाकरण सक्षम करना होगा।

  1. अपने परीक्षण उपकरण पर, अपने परीक्षक ईमेल खाते में साइन इन करें और फायरबेस से आमंत्रण खोलें।

    छवि6.पीएनजी
  2. अपने Google खाते से साइन इन करें और वितरित रिलीज़ का परीक्षण करने का निमंत्रण स्वीकार करें। एक विकल्प के रूप में, आप फायरबेस ऐप टेस्टर भी डाउनलोड कर सकते हैं, जो डाउनलोड किए गए रिलीज़ को आपके डिवाइस के Downloads फ़ोल्डर में जोड़े जाने से रोकता है। यह रिलीज़ के बारे में अतिरिक्त जानकारी भी प्रदर्शित करता है, जैसे डाउनलोड प्रगति और रिलीज़ संस्करण।

    image9.png
  3. इसे प्ले स्टोर से इंस्टॉल करने के लिए रिलीज़ पर डाउनलोड पर टैप करें।
  4. संकेत मिलने पर, आंतरिक ऐप साझाकरण सक्षम करने के लिए शेष चरणों को पूरा करें (निर्देश आपके परीक्षण डिवाइस पर प्रदर्शित होते हैं और केवल एक बार पूरा करने की आवश्यकता होती है)।

एक बार डाउनलोड पूरा हो जाने पर, आपकी रिलीज़ स्वचालित रूप से आपके डिवाइस की होम स्क्रीन पर एक शॉर्टकट के रूप में दिखाई देगी।

7. बधाई हो!

आपने अभी-अभी ऐप बंडल अपलोड करने और परीक्षकों को रिलीज़ वितरित करने के लिए फायरबेस ऐप डिस्ट्रीब्यूशन का उपयोग किया है।

अगले कदम