फायरबेस सीएलआई का उपयोग करके परीक्षकों को एंड्रॉइड ऐप्स वितरित करें

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

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

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

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

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

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

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

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

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

  3. अपना ऐप अपलोड करने और इसे परीक्षकों को वितरित करने के लिए appdistribution:distribute कमांड चलाएँ। वितरण को कॉन्फ़िगर करने के लिए निम्नलिखित पैरामीटर का उपयोग करें:

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

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

    --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.apk  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    रिलीज़ अपलोड के बाद फायरबेस सीएलआई निम्नलिखित लिंक आउटपुट करता है। ये लिंक आपको बायनेरिज़ प्रबंधित करने में मदद करते हैं और यह सुनिश्चित करते हैं कि परीक्षकों और अन्य डेवलपर्स के पास सही रिलीज़ है:

    • firebase_console_uri - एकल रिलीज प्रदर्शित करने वाले फायरबेस कंसोल का एक लिंक। आप इस लिंक को अपने संगठन के अन्य डेवलपर्स के साथ साझा कर सकते हैं।
    • testing_uri - परीक्षक अनुभव (एंड्रॉइड मूल ऐप) में रिलीज़ का एक लिंक जो परीक्षकों को रिलीज़ नोट्स देखने और ऐप को उनके डिवाइस पर इंस्टॉल करने देता है। लिंक का उपयोग करने के लिए परीक्षक को रिलीज़ तक पहुंच की आवश्यकता होती है।
    • binary_download_uri - एक हस्ताक्षरित लिंक जो सीधे ऐप बाइनरी (एपीके या एएबी फ़ाइल) को डाउनलोड और इंस्टॉल करता है। लिंक एक घंटे के बाद समाप्त हो जाता है.

    परीक्षकों और समूहों को प्रबंधित करें

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

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

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

    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 का उपयोग करके भी परीक्षक निर्दिष्ट कर सकते हैं।

    यदि आपके पास बड़ी संख्या में परीक्षक हैं तो आपको समूहों का उपयोग करने पर विचार करना चाहिए: आप अपने फायरबेस प्रोजेक्ट में समूह बनाने या हटाने के लिए appdistribution:group:create और appdistribution:group:delete उपयोग कर सकते हैं।

    appdistribution:testers:add और appdistribution:testers:remove कमांड के लिए एक समूह निर्दिष्ट करने के लिए --group-alias का उपयोग करें।

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

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

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

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

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

अगले कदम