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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

1 अवलोकन

c7a9160ef7b184c7.png22e0b52f771c060d.png

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

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

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

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

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

आप इस ट्यूटोरियल का उपयोग कैसे करेंगे?

इसके माध्यम से ही पढ़ें इसे पढ़ें और अभ्यास पूरा करें

आप Android ऐप्स बनाने के अपने अनुभव का मूल्यांकन कैसे करेंगे?

नौसिखिए मध्यम प्रवीण

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

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

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

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

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

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

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

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

एक नया Firebase प्रोजेक्ट जोड़ें

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

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

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

Firebase में ऐप्लिकेशन जोड़ें

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मुख्य गतिविधि.kt

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

अब checkForUpdate() विधि को लागू करते हैं।

मुख्य गतिविधि.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. अपना ऐप डाउनलोड करने के लिए परीक्षक बनाएं और आमंत्रित करें

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

अपना ऐप बनाएं

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

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

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

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

623460c3c8a82ce6.png

  1. आरंभ करें पर क्लिक करें

bf503b25066ff4a4.png

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

3343048f0930e84b.png

  1. टेस्टर्स को बिल्ड उपलब्ध कराने के लिए डिस्ट्रीब्यूट पर क्लिक करें।

2be58fe195928bf9.png

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

9935a41810344c61.png

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

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

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

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

c18cb684f8e82ad6.png

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

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

5414d9a536f25ece.png

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

b059e09acaa4779f.png

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

22e0b52f771c060d.png

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

c9f33df16a2680d.png

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

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

2dfa702edfdce6b8.png

टेस्ट बिल्ड अलर्ट

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

987e3d0ba4e56f84.png

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

a7c7cd15d60bc764.png

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

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

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

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

चेकफॉरअपडेट () कॉल पर कमेंट करके ऑन-रेज्यूमे में अपडेट चेकिंग को स्वचालित रूप से अक्षम करें।

मुख्य गतिविधि.kt

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

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

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

मुख्य गतिविधि.kt

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

अंत में isTesterSignedIn विधि को लागू करते हैं।

मुख्य गतिविधि.kt

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

अपने कार्यान्वयन का निर्माण और परीक्षण करें

8. बधाई!

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

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

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

अगले कदम

और अधिक जानें

एक सवाल है?

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