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

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

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

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

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

• Play सुविधा वितरण और Play संपत्ति वितरण जैसी ऐप्लिकेशन बंडल सुविधाओं का परीक्षण करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

3. अपने Firebase Android ऐप को अपने Google Play डेवलपर खाते से लिंक करें:

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

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

   3. ऐप वितरण एकीकरण को सक्षम करने के लिए ऑन-स्क्रीन निर्देशों का पालन करें और Google Play से लिंक करने के लिए कौन से Firebase Android ऐप्स का चयन करें।

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

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

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

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

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

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

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	वे परीक्षक समूह जिन्हें आप आमंत्रित करना चाहते हैं ( परीक्षकों को प्रबंधित करें देखें)। समूहों का उपयोग करके निर्दिष्ट किया गया है समूह उपनाम , जिसे आप Firebase कंसोल में देख सकते हैं। आप समूहों को अल्पविराम से अलग की गई सूची के रूप में निर्दिष्ट कर सकते हैं: --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_console_uri - एकल रिलीज़ प्रदर्शित करने वाले Firebase कंसोल का लिंक। आप इस लिंक को अपने संगठन में अन्य डेवलपर्स के साथ साझा कर सकते हैं।
   • testing_uri - टेस्टर अनुभव (एंड्रॉइड नेटिव ऐप) में रिलीज़ का एक लिंक जो परीक्षकों को रिलीज़ नोट्स देखने और ऐप को अपने डिवाइस पर इंस्टॉल करने देता है। लिंक का उपयोग करने के लिए परीक्षक को रिलीज़ तक पहुंच की आवश्यकता होती है।
   • binary_download_uri - एक हस्ताक्षरित लिंक जो सीधे ऐप बाइनरी (एपीके या एएबी फ़ाइल) को डाउनलोड और इंस्टॉल करता है। लिंक एक घंटे के बाद समाप्त हो जाता है।

   रिलीज़ को वितरित करने के अलावा, आप नए परीक्षकों को आमंत्रित करने के लिए appdistribution:testers:add और appdistribution:testers:remove भी उपयोग कर सकते हैं या अपने Firebase प्रोजेक्ट से मौजूदा परीक्षकों को हटा सकते हैं। एक बार आपके 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 दिन बाद होता है, तो कंसोल और आपके परीक्षक की टेस्ट डिवाइस पर बिल्ड की सूची दोनों में एक समाप्ति सूचना दिखाई देती है।

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

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

अगले कदम

• परीक्षकों के लिए आपके ऐप (स्क्रीनशॉट सहित) के बारे में फ़ीडबैक भेजना आसान बनाने के लिए इन-ऐप फ़ीडबैक लागू करें।

• अपने ऐप के नए बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर अपने परीक्षकों को इन-ऐप अलर्ट प्रदर्शित करने का तरीका जानें।

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