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

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

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

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

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

  • प्ले फ़ीचर डिलीवरी और प्ले एसेट डिलीवरी जैसी ऐप बंडल सुविधाओं का परीक्षण करें।

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

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

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

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

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

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

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

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

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

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

    • Google Play में ऐप और Firebase Android ऐप दोनों एक ही पैकेज नाम का उपयोग करके पंजीकृत हैं।

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

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

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

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

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

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

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

चरण 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

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

    --test-devices
    --test-devices-file

    निम्नलिखित वितरण प्रकार स्वचालित परीक्षक बीटा सुविधा का हिस्सा हैं।

    जिन परीक्षण उपकरणों को आप वितरित करना चाहते हैं उनका निर्माण होता है ( स्वचालित परीक्षण देखें)।

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

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

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

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    स्वचालित लॉगिन के लिए उपयोगकर्ता नाम स्वचालित परीक्षणों के दौरान उपयोग किया जाएगा।

    --test-password
    --test-password-file

    स्वचालित परीक्षणों के दौरान स्वचालित लॉगिन के लिए पासवर्ड का उपयोग किया जाएगा।

    या, आप पासवर्ड वाली सादे पाठ फ़ाइल का पथ निर्दिष्ट कर सकते हैं:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    स्वचालित परीक्षणों के दौरान उपयोग किए जाने वाले स्वचालित लॉगिन के लिए उपयोगकर्ता नाम फ़ील्ड के लिए संसाधन नाम।

    --test-password-resource

    स्वचालित परीक्षणों के दौरान उपयोग किए जाने वाले स्वचालित लॉगिन के लिए पासवर्ड फ़ील्ड के लिए संसाधन नाम।

    --test-non-blocking

    स्वचालित परीक्षण अतुल्यकालिक रूप से चलाएँ। स्वचालित परीक्षण परिणामों के लिए फायरबेस कंसोल पर जाएँ।

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

    firebase appdistribution:distribute test.aab  \
        --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 दिन शेष होते हैं, तो रिलीज़ पर परीक्षक के बगल में फायरबेस कंसोल में एक समाप्ति सूचना दिखाई देती है। किसी आमंत्रण को परीक्षक पंक्ति पर ड्रॉप-डाउन मेनू का उपयोग करके पुनः भेजकर नवीनीकृत किया जा सकता है।

अगले कदम