Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Firebase CLI का उपयोग करके परीक्षकों को Android ऐप्स वितरित करें

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

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

ऐप वितरण आपके द्वारा अपलोड किए गए एएबी को संसाधित करने और आपके परीक्षकों के डिवाइस कॉन्फ़िगरेशन के लिए अनुकूलित किए गए एपीके की सेवा के लिए Google Play की आंतरिक ऐप साझाकरण सेवा के साथ एकीकृत होता है। एएबी वितरित करने से आप निम्न कार्य कर सकते हैं:

  • अनुकूलित APK चलाएं (Google Play द्वारा प्रस्तुत) जो आपके परीक्षकों के उपकरणों के लिए अनुकूलित हैं।

  • डिवाइस-विशिष्ट मुद्दों को उजागर करें और डीबग करें।

  • टेस्ट ऐप बंडल फ़ीचर जैसे Play फ़ीचर डिलीवरी और Play एसेट डिलीवरी

  • अपने परीक्षकों के लिए डाउनलोड का आकार कम करें।

आवश्यक अनुमतियाँ

एएबी को ऐप वितरण में अपलोड करने के लिए, आपको अपने फायरबेस ऐप को Google Play में किसी ऐप से लिंक करना होगा। इन कार्यों को करने के लिए आपके पास आवश्यक स्तर की पहुंच होनी चाहिए।

यदि आपके पास आवश्यक Firebase एक्सेस नहीं है, तो आप Firebase प्रोजेक्ट स्वामी से Firebase कंसोल IAM सेटिंग के माध्यम से आपको लागू भूमिका सौंपने के लिए कह सकते हैं। अगर आपके पास अपने फायरबेस प्रोजेक्ट तक पहुंचने के बारे में प्रश्न हैं, जिसमें मालिक को ढूंढना या असाइन करना शामिल है, तो "फायरबेस प्रोजेक्ट्स की अनुमतियां और एक्सेस" अक्सर पूछे जाने वाले प्रश्नों की समीक्षा करें।

निम्न तालिका Google Play में एक Firebase ऐप को किसी ऐप से लिंक करने के साथ-साथ AAB को अपलोड करने पर लागू होती है।

फायरबेस कंसोल में कार्रवाई आवश्यक IAM अनुमति IAM भूमिका (भूमिकाएं) जिनमें डिफ़ॉल्ट रूप से आवश्यक अनुमतियां शामिल हैं अतिरिक्त आवश्यक भूमिका (भूमिकाएं)
किसी Firebase ऐप्लिकेशन को Google Play में ऐप्लिकेशन से लिंक करें firebase.playLinks.update निम्नलिखित भूमिकाओं में से एक: व्यवस्थापक के रूप में Google Play डेवलपर खाते तक पहुंच
ऐप वितरण में एएबी अपलोड करें firebaseappdistro.releases.update निम्नलिखित भूमिकाओं में से एक: —–

शुरू करने से पहले

  1. यदि आपने पहले से ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें । इस वर्कफ़्लो के अंत में, आपके Firebase प्रोजेक्ट में आपके पास एक Firebase Android ऐप होगा।

    अगर आप किसी अन्य Firebase उत्पादों का उपयोग नहीं कर रहे हैं, तो आपको केवल एक प्रोजेक्ट बनाना होगा और अपना ऐप पंजीकृत करना होगा। यदि आप अतिरिक्त उत्पादों का उपयोग करने का निर्णय लेते हैं, तो अपने Android प्रोजेक्ट में Firebase जोड़ें में सभी चरणों को पूरा करना सुनिश्चित करें।

  2. Google Play से Firebase लिंक बनाने और AAB अपलोड करने के लिए, सुनिश्चित करें कि आपका ऐप निम्नलिखित आवश्यकताओं को पूरा करता है:

    • Google Play में ऐप और फायरबेस एंड्रॉइड ऐप दोनों एक ही पैकेज नाम का उपयोग करके पंजीकृत हैं।

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

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

  3. अपने फायरबेस एंड्रॉइड ऐप को अपने Google Play डेवलपर खाते से लिंक करें:

    1. फायरबेस कंसोल में, अपनी प्रोजेक्ट सेटिंग्स पर जाएं, फिर इंटीग्रेशन टैब चुनें।

    2. Google Play कार्ड पर, लिंक पर क्लिक करें।
      यदि आपके पास पहले से Google Play के लिंक हैं, तो इसके बजाय प्रबंधित करें पर क्लिक करें।

    3. ऐप वितरण एकीकरण को सक्षम करने के लिए ऑन-स्क्रीन निर्देशों का पालन करें और चुनें कि कौन से फायरबेस एंड्रॉइड ऐप को Google Play से लिंक करना है।

    Google Play से लिंक करने के बारे में और जानें।

चरण 1. अपना ऐप बनाएं

जब आप परीक्षकों को अपने ऐप्लिकेशन का रिलीज़-पूर्व संस्करण वितरित करने के लिए तैयार हों, तो अपना AAB बनाएं (निर्देशों के लिए Android Studio दस्तावेज़ देखें)।

चरण 2. अपने ऐप को परीक्षकों को वितरित करें

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

  1. फायरबेस सीएलआई के नवीनतम संस्करण को स्थापित या अपडेट करें (हम आपके ओएस के लिए विशिष्ट सीएलआई के लिए स्टैंडअलोन बाइनरी डाउनलोड करने की सलाह देते हैं)। साइन इन करना और परीक्षण करना सुनिश्चित करें कि आप अपनी परियोजनाओं तक पहुंच सकते हैं।
  2. Firebase कंसोल के ऐप डिस्ट्रीब्यूशन पेज में, उस ऐप को चुनें जिसे आप डिस्ट्रीब्यूट करना चाहते हैं, फिर गेट स्टार्ट पर क्लिक करें।
  3. अपना ऐप अपलोड करने और इसे परीक्षकों को वितरित करने के लिए appdistribution:distribute कमांड चलाएँ। वितरण को कॉन्फ़िगर करने के लिए निम्नलिखित मापदंडों का उपयोग करें:

    ऐप वितरण: वितरण विकल्प
    --app

    आवश्यक : आपके ऐप का फायरबेस ऐप आईडी। आप सामान्य सेटिंग पृष्ठ पर, Firebase कंसोल में ऐप आईडी पा सकते हैं।

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    एक ताज़ा टोकन जो तब प्रिंट होता है जब आप अपने सीआई वातावरण को फायरबेस सीएलआई के साथ प्रमाणित करते हैं (अधिक जानकारी के लिए सीआई सिस्टम के साथ सीएलआई का उपयोग करें पढ़ें)।

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    इस निर्माण के लिए नोट जारी करें।

    आप या तो सीधे रिलीज़ नोट निर्दिष्ट कर सकते हैं:

    --release-notes "Text of release notes"

    या, एक सादे पाठ फ़ाइल का पथ निर्दिष्ट करें:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    उन परीक्षकों के ईमेल पते जिन्हें आप आमंत्रित करना चाहते हैं।

    आप परीक्षकों को ईमेल पतों की अल्पविराम से अलग की गई सूची के रूप में निर्दिष्ट कर सकते हैं:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    या, आप ईमेल पतों की अल्पविराम से अलग की गई सूची वाली सादा पाठ फ़ाइल का पथ निर्दिष्ट कर सकते हैं:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

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

    आप समूहों को अल्पविराम से अलग की गई सूची के रूप में निर्दिष्ट कर सकते हैं:

    --groups "qa-team, trusted-testers"

    या, आप समूह नामों की अल्पविराम से अलग की गई सूची वाली सादा पाठ फ़ाइल का पथ निर्दिष्ट कर सकते हैं:

    --groups-file "/path/to/groups.txt"
    --debug

    एक ध्वज जिसे आप वर्बोज़ लॉग आउटपुट प्रिंट करने के लिए शामिल कर सकते हैं।

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

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    रिलीज़ वितरित करने के अलावा, आप अपने Firebase प्रोजेक्ट से नए परीक्षकों को आमंत्रित करने या मौजूदा परीक्षकों को निकालने के लिए appdistribution:testers:add एंड appdistribution:testers:remove का भी उपयोग कर सकते हैं। आपके Firebase प्रोजेक्ट में परीक्षक जोड़े जाने के बाद, आप उन्हें अलग-अलग रिलीज़ में जोड़ सकते हैं। एक बार जब आप किसी परीक्षक को हटा देते हैं, तो उसके पास आपके प्रोजेक्ट में रिलीज़ की एक्सेस नहीं रह जाएगी। ध्यान दें कि जिन परीक्षकों को हाल ही में हटाया गया है, वे कुछ समय के लिए आपकी रिलीज़ तक पहुंच बनाए रख सकते हैं।

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

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    परीक्षक ईमेल को एक स्थान से अलग किया जाना चाहिए। आप --file /path/to/testers.txt का उपयोग करके भी परीक्षक निर्दिष्ट कर सकते हैं।

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

जिन परीक्षकों को ऐप का परीक्षण करने के लिए आमंत्रित नहीं किया गया है, उन्हें आरंभ करने के लिए ईमेल आमंत्रण प्राप्त होते हैं, और मौजूदा परीक्षकों को ईमेल सूचनाएं प्राप्त होती हैं कि एक नया बिल्ड परीक्षण के लिए तैयार है (परीक्षण ऐप को कैसे स्थापित करें, इस पर निर्देशों के लिए परीक्षक सेट अप मार्गदर्शिका पढ़ें)। आप प्रत्येक परीक्षक की स्थिति की निगरानी कर सकते हैं-क्या उन्होंने आमंत्रण स्वीकार किया है और क्या उन्होंने ऐप डाउनलोड किया है-Firebase कंसोल में।

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

अगले कदम

CI/CD का उपयोग करके QA परीक्षकों को Android ऐप्स वितरित करने के सर्वोत्तम अभ्यासों के बारे में जानें।