फायरबेस ऐप डिस्ट्रीब्यूशन एंड्रॉइड एसडीके - कोडेलैब के साथ अपने नए ऐप रिलीज के बारे में परीक्षकों को सचेत करें

1 अवलोकन

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

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

• परीक्षकों को प्री-रिलीज़ ऐप वितरित करने के लिए ऐप वितरण का उपयोग कैसे करें
• ऐप डिस्ट्रीब्यूशन एंड्रॉइड एसडीके को अपने ऐप में कैसे एकीकृत करें
• जब कोई नया प्री-रिलीज़ बिल्ड इंस्टॉल करने के लिए तैयार हो तो परीक्षक को कैसे सचेत किया जाए
• अपनी परीक्षण आवश्यकताओं के अनुरूप एसडीके को कैसे अनुकूलित करें

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

• नवीनतम एंड्रॉइड स्टूडियो संस्करण।
• नमूना कोड।
• Android 4.4+ और Google Play सेवाओं 9.8 या बाद के संस्करण वाला एक परीक्षण उपकरण, या Google Play सेवाओं 9.8 या बाद के संस्करण वाला एक एमुलेटर।
• यदि किसी उपकरण का उपयोग कर रहे हैं, तो एक कनेक्शन केबल।

2. नमूना कोड प्राप्त करें

कमांड लाइन से GitHub रिपॉजिटरी को क्लोन करें।

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

यदि आपके पास git स्थापित नहीं है, तो आप नमूना प्रोजेक्ट को इसके GitHub पेज से या इस लिंक पर क्लिक करके भी डाउनलोड कर सकते हैं।

3. स्टार्टर ऐप आयात करें

एंड्रॉइड स्टूडियो से, codelab-appdistribution-android/start डायरेक्टरी चुनें ( ) नमूना कोड डाउनलोड से ( फ़ाइल > खोलें > .../कोडलैब-ऐपडिस्ट्रीब्यूशन-एंड्रॉइड/स्टार्ट)।

अब आपके पास एंड्रॉइड स्टूडियो में स्टार्ट प्रोजेक्ट खुला होना चाहिए।

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

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

1. फायरबेस कंसोल खोलें।
2. प्रोजेक्ट जोड़ें चुनें और फिर अपने प्रोजेक्ट को "फ़ायरबेस कोडेलैब" नाम दें।

इस प्रोजेक्ट के लिए आपको Google Analytics सक्षम करने की आवश्यकता नहीं है.

3. प्रोजेक्ट बनाएं पर क्लिक करें.

फ़ायरबेस में एक ऐप जोड़ें

अपने ऐप को फायरबेस के साथ पंजीकृत करें । पैकेज नाम के रूप में "com.google.firebase.appdistributioncodelab" का उपयोग करें।

अपने ऐप में google-services.json फ़ाइल जोड़ें

पैकेज का नाम जोड़ने और रजिस्टर का चयन करने के बाद, अपने ऐप में google-services.json जोड़ने के लिए इन चरणों का पालन करें:

1. अपनी फायरबेस एंड्रॉइड कॉन्फ़िगरेशन फ़ाइल प्राप्त करने के लिए google-services.json डाउनलोड करें पर क्लिक करें।
2. अपने प्रोजेक्ट में google-services.json फ़ाइल को app निर्देशिका में कॉपी करें।
3. फ़ाइल डाउनलोड होने के बाद आप कंसोल में दिखाए गए अगले चरणों को छोड़ सकते हैं (वे बिल्ड-एंड्रॉइड-स्टार्ट प्रोजेक्ट में आपके लिए पहले ही किए जा चुके हैं)।

अपने फायरबेस ऐप से मिलान करने के लिए एप्लिकेशन आईडी अपडेट करें

1. बाएं मेनू (प्रोजेक्ट टैब) में, सुनिश्चित करें कि आप "एंड्रॉइड" पर हैं। "ग्रैडल स्क्रिप्ट्स" टैब देखें और ढूंढें और अपना मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल खोलें (आमतौर पर app/build.gradle.kts )।
2. अपने फायरबेस ऐप की एप्लिकेशन आईडी से मिलान करने के लिए applicationId प्रॉपर्टी बदलें। यह "com.google.firebase.appdistributioncodelab" होना चाहिए

अपने प्रोजेक्ट को ग्रैडल फ़ाइलों के साथ सिंक करें

यह सुनिश्चित करने के लिए कि सभी निर्भरताएँ आपके ऐप के लिए उपलब्ध हैं, एंड्रॉइड स्टूडियो टूलबार से फ़ाइल > ग्रैडल फ़ाइलों के साथ सिंक प्रोजेक्ट का चयन करके अपने प्रोजेक्ट को ग्रैडल फ़ाइलों के साथ सिंक करें।

5. ऐप डिस्ट्रीब्यूशन एंड्रॉइड एसडीके के साथ इन-ऐप नए बिल्ड अलर्ट सेट करें

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

इन-ऐप अलर्ट कॉन्फ़िगर करें

ऐप वितरण एंड्रॉइड एसडीके आपके परीक्षकों के लिए इन-ऐप बिल्ड अलर्ट सेट करने के दो तरीके प्रदान करता है:

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

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

1. जाँचता है कि क्या किसी परीक्षक ने अलर्ट सक्षम किया है। यदि नहीं, तो विधि एक पूर्व-निर्मित संवाद प्रदर्शित करती है जो परीक्षकों को अपने Google खाते से ऐप वितरण में साइन इन करने के लिए प्रेरित करती है।

अलर्ट सक्षम करना परीक्षण डिवाइस पर एक बार की प्रक्रिया है जो आपके ऐप के अपडेट के दौरान जारी रहती है। जब तक ऐप अनइंस्टॉल नहीं हो जाता या जब तक signOutTester विधि को कॉल नहीं किया जाता तब तक परीक्षण डिवाइस पर अलर्ट सक्षम रहते हैं।

2. परीक्षक को स्थापित करने के लिए नए उपलब्ध बिल्ड की जाँच करता है।
3. एक पूर्व-निर्मित अलर्ट प्रदर्शित करता है जो परीक्षक को नवीनतम रिलीज़ डाउनलोड करने के लिए प्रेरित करता है।
4. अद्यतन के साथ आगे बढ़ने से पहले नए बिल्ड प्रकार की जाँच करता है:
5. यदि नया बिल्ड एक ऐप बंडल (एएबी) है, तो अपडेट प्रक्रिया को पूरा करने के लिए परीक्षक को प्ले स्टोर पर रीडायरेक्ट करता है।
6. यदि नया बिल्ड एक एपीके है, तो एसडीके पृष्ठभूमि में नए बिल्ड को डाउनलोड करता है और डाउनलोड पूरा होने पर परीक्षक को नया बिल्ड स्थापित करने के लिए संकेत देता है। SDK NotificationManager. आप updateIfNewReleaseAvailable कार्य में onProgressUpdate हैंडलर संलग्न करके अपना स्वयं का प्रगति संकेतक जोड़ सकते हैं।

आप अपने ऐप में किसी भी समय updateIfNewReleaseAvailable() पर कॉल कर सकते हैं। उदाहरण के लिए, आप MainActivity की onResume() विधि के दौरान updateIfNewReleaseAvailable() को कॉल कर सकते हैं:

MainActivity.kt खोलें, और onResume() विधि इस प्रकार बनाएं:

MainActivity.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

आइए अब checkForUpdate() विधि लागू करें।

MainActivity.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. अपना ऐप डाउनलोड करने के लिए परीक्षकों को बनाएं और आमंत्रित करें

इस चरण में, आप अपना ऐप बनाते हैं और फायरबेस कंसोल का उपयोग करके परीक्षकों को बिल्ड वितरित करके अपने कार्यान्वयन का परीक्षण करते हैं।

अपना ऐप बनाएं

जब आप परीक्षकों को अपने ऐप का प्री-रिलीज़ संस्करण वितरित करने के लिए तैयार हों, तो अपनी सामान्य प्रक्रिया का उपयोग करके अपना एपीके बनाएं। आपको अपनी डिबग कुंजी या ऐप साइनिंग कुंजी के साथ एपीके पर हस्ताक्षर करना होगा।

अपना ऐप परीक्षकों को वितरित करें

अपने ऐप को परीक्षकों तक वितरित करने के लिए, फायरबेस कंसोल का उपयोग करके एपीके फ़ाइल अपलोड करें:

1. फायरबेस कंसोल का ऐप डिस्ट्रीब्यूशन पेज खोलें। संकेत मिलने पर अपना फायरबेस प्रोजेक्ट चुनें।
2. रिलीज़ पृष्ठ पर, ड्रॉप-डाउन मेनू से वह ऐप चुनें जिसे आप वितरित करना चाहते हैं।

3. प्रारंभ करें पर क्लिक करें

4. अपने ऐप की एपीके फ़ाइल को अपलोड करने के लिए उसे कंसोल पर खींचें।
5. जब अपलोड पूरा हो जाए, तो उन परीक्षक समूहों और व्यक्तिगत परीक्षकों को निर्दिष्ट करें जिन्हें आप बिल्ड प्राप्त करना चाहते हैं। (आमंत्रण प्राप्त करने के लिए अपना ईमेल जोड़ें।) फिर, बिल्ड के लिए रिलीज़ नोट्स जोड़ें। परीक्षक समूह बनाने के बारे में अधिक जानने के लिए, परीक्षक जोड़ें और हटाएँ देखें।

6. परीक्षकों को बिल्ड उपलब्ध कराने के लिए वितरण पर क्लिक करें।

फायरबेस कंसोल में, अब आप अपने ऐप की रिलीज़ के तहत जोड़े गए परीक्षकों को देख सकते हैं।

चूँकि आपने अपना ईमेल पता शामिल किया है, आपको फायरबेस ऐप डिस्ट्रीब्यूशन से एक ईमेल प्राप्त होगा जो आपको ऐप का परीक्षण करने के लिए आमंत्रित करेगा। अब आप पहले परीक्षक हैं! अपने परीक्षण उपकरण पर परीक्षक के रूप में स्थापित होने के लिए निमंत्रण स्वीकार करें में दिए गए निर्देशों का पालन करें।

आमंत्रण स्वीकार कीजिये

रिलीज़ को डाउनलोड करने और उसका परीक्षण करने के लिए आपको पहले निमंत्रण स्वीकार करना होगा।

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

परीक्षण डिवाइस से रिलीज़ डाउनलोड करें

जब आप AppDistribution कोडलैब ऐप पर नेविगेट करते हैं, तो आप देख सकते हैं कि रिलीज़ डाउनलोड करने के लिए तैयार है।

1. डाउनलोड पर टैप करें, फिर ऐप इंस्टॉल करें और चलाएं!
2. जब ऐप शुरू होता है, तो यह आपसे नए बिल्ड अलर्ट सक्षम करने के लिए कहता है। चालू करें टैप करें.

3. अपने परीक्षक खाते से साइन इन करें..

आप ऐप पर वापस आ गए हैं. अगली बार जब आप ऐप चलाएंगे, तो आपको साइन इन करने या अलर्ट स्वीकार करने की आवश्यकता नहीं है

अपने परीक्षकों को एक अपडेट वितरित करें

1. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल (आमतौर पर ऐप/बिल्ड.ग्रेडल) में अपने वर्जननाम को "1.1" और वर्जनकोड को 2 पर अपडेट करें।
2. अपनी सामान्य प्रक्रिया का उपयोग करके अपना एपीके बनाएं। आपको अपनी डिबग कुंजी या ऐप साइनिंग कुंजी के साथ एपीके पर हस्ताक्षर करना होगा।
3. इस नए एपीके को अपने फायरबेस कंसोल में अपलोड करें, अपना ईमेल फिर से परीक्षक के रूप में जोड़ें और वितरित करें पर क्लिक करें।

बिल्ड अलर्ट का परीक्षण करें

1. सुनिश्चित करें कि यदि ऐप खुला था तो आपने उसे बंद कर दिया है।
2. ऐप पुनः प्रारंभ करें.
3. जब ऐप पुनरारंभ होता है, तो आपको एक नया संस्करण उपलब्ध अलर्ट प्राप्त होता है।

4. नवीनतम संस्करण प्राप्त करने के लिए, अपडेट पर क्लिक करें।
5. यदि संकेत दिया जाए, तो अज्ञात स्रोतों से इंस्टॉल को सक्षम करने का विकल्प चुनें।
6. अगली स्क्रीन पर इंस्टॉल (या अपडेट ) पर क्लिक करें।

7. बधाई हो! आप अपने ऐप को बिल्ट-इन अलर्ट के साथ अपडेट करने में सक्षम थे।

7. परीक्षक साइन-इन को अनुकूलित करें

साइनइनटेस्टर/साइनआउटटेस्टर और आईटेस्टरसाइनडइन विधियां आपको अपने परीक्षक के साइन-इन अनुभव को अनुकूलित करने में अधिक लचीलापन प्रदान करती हैं, ताकि यह आपके ऐप के स्वरूप और अनुभव से बेहतर ढंग से मेल खा सके।

निम्नलिखित उदाहरण यह जांचता है कि क्या परीक्षक ने पहले से ही अपने फायरबेस ऐप डिस्ट्रीब्यूशन परीक्षक खाते में साइन इन किया है, इसलिए आप अपना साइन-इन यूआई केवल उन परीक्षकों के लिए प्रदर्शित करना चुन सकते हैं जिन्होंने अभी तक साइन इन नहीं किया है। परीक्षक के साइन इन करने के बाद, आप ऐसा कर सकते हैं यह जांचने के लिए checkForUpdate पर कॉल करें कि परीक्षक के पास नए निर्माण तक पहुंच है या नहीं।

आइए checkForUpdate() कॉल पर टिप्पणी करके onResume में स्वचालित रूप से अपडेट की जाँच को अक्षम करें।

MainActivity.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

इसके बजाय, checkForUpdate() पहले से ही अपडेटबटन के OnClickListener में जोड़ा गया है।

अब, आइए हमारी साइनइन () विधि को लागू करें जो उपयोगकर्ता को साइन इन करेगा यदि वे साइन आउट हैं, या यदि उपयोगकर्ता पहले से साइन इन हैं तो उन्हें साइन आउट करेगा।

MainActivity.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

अंत में आइए isTesterSignedIn विधि लागू करें।

MainActivity.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

अपना कार्यान्वयन बनाएं और उसका परीक्षण करें

8. बधाई हो!

आपने फायरबेस ऐप डिस्ट्रीब्यूशन एंड्रॉइड एसडीके का उपयोग करके ऐप में "इन-ऐप अलर्ट डिस्प्ले" सुविधा बनाई है।

हमने क्या कवर किया है

• फायरबेस ऐप वितरण
• फायरबेस ऐप वितरण नए अलर्ट एंड्रॉइड एसडीके

अगले कदम

• फास्टलेन प्लगइन का उपयोग करना
• सीएलआई उपकरण का उपयोग करना
• ग्रेडेल का उपयोग करना

और अधिक जानें

• Firebase.google.com

एक सवाल है?

• स्टैकओवरफ़्लो 'फ़ायरबेस-ऐप-वितरण '
• फायरबेस समुदाय स्लैक चैनल #ऐप-वितरण

मुद्दों की रिपोर्ट करें

• जीथब मुद्दे