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

1 अवलोकन

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

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

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

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

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

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

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

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

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

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

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

अब जब आपने इन चरणों को पूरा कर लिया है, तो आपका Firebase ऐप आपके 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 ) में, Google के Maven रिपॉजिटरी को pluginManagement ब्लॉक में जोड़ें।

    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
   

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

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

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

~/your-android-project$ firebase login

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

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

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

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

• appID : आपके ऐप की Firebase ऐप आईडी। आप इसे अपनी प्रोजेक्ट सेटिंग्स के सामान्य टैब में पा सकते हैं।
• 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. अपने परीक्षण उपकरण पर, अपने परीक्षक ईमेल खाते में साइन इन करें और Firebase से आमंत्रण खोलें।
   
   
2. अपने Google खाते से साइन इन करें और वितरित रिलीज़ का परीक्षण करने के लिए आमंत्रण स्वीकार करें। एक विकल्प के रूप में, आप फायरबेस ऐप टेस्टर भी डाउनलोड कर सकते हैं, जो डाउनलोड की गई रिलीज़ को आपके डिवाइस के Downloads फ़ोल्डर में जोड़े जाने से रोकता है। यह रिलीज़ के बारे में अतिरिक्त जानकारी भी प्रदर्शित करता है, जैसे डाउनलोड प्रगति और रिलीज़ संस्करण।
   
   
3. Play Store से इसे इंस्टॉल करने के लिए रिलीज पर डाउनलोड टैप करें।
4. संकेत मिलने पर, आंतरिक ऐप साझाकरण को सक्षम करने के लिए शेष चरणों को पूरा करें (निर्देश आपके परीक्षण डिवाइस पर प्रदर्शित होते हैं और केवल एक बार पूरा करने की आवश्यकता होती है)।

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

7. बधाई हो!

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

अगले कदम

• अपनी रिलीज़ के लिए परीक्षकों को प्रबंधित करने के तरीके के बारे में अधिक जानने के लिए ऐप वितरण दस्तावेज़ देखें।
• अपने ऐप को परिनियोजित करने के लिए उपयोग किए जा सकने वाले अन्य टूल के बारे में जानकारी के लिए अपना Android ऐप बंडल बनाएं और उसका परीक्षण करें देखें।