यह मार्गदर्शिका बताती है कि Firebase CLI का उपयोग करके परीक्षकों को APK कैसे वितरित करें। सीएलआई टूल आपको परीक्षकों को निर्दिष्ट करने देता है और बिल्ड के लिए नोट्स जारी करता है, फिर बिल्ड को तदनुसार वितरित करता है।
शुरू करने से पहले
यदि आपने पहले से नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें ।
यदि आप किसी अन्य फायरबेस उत्पाद का उपयोग नहीं कर रहे हैं, तो आपको केवल एक प्रोजेक्ट बनाना होगा और अपना ऐप पंजीकृत करना होगा। हालांकि, यदि आप भविष्य में अतिरिक्त उत्पादों का उपयोग करने का निर्णय लेते हैं, तो उपरोक्त लिंक किए गए पृष्ठ पर सभी चरणों को पूरा करना सुनिश्चित करें।
चरण 1. अपना ऐप बनाएं
जब आप परीक्षकों को अपने ऐप्लिकेशन का रिलीज़-पूर्व संस्करण वितरित करने के लिए तैयार हों, तो अपनी सामान्य प्रक्रिया का उपयोग करके अपना APK बनाएं. आपको अपनी डीबग कुंजी या ऐप साइनिंग कुंजी से APK पर हस्ताक्षर करना होगा।
चरण 2. अपने ऐप को परीक्षकों को वितरित करें
परीक्षकों को अपना ऐप वितरित करने के लिए, Firebase CLI का उपयोग करके अपने ऐप की फ़ाइल अपलोड करें:
- फायरबेस सीएलआई के नवीनतम संस्करण को स्थापित या अपडेट करें (हम आपके ओएस के लिए विशिष्ट सीएलआई के लिए स्टैंडअलोन बाइनरी डाउनलोड करने की सलाह देते हैं)। साइन इन करना और परीक्षण करना सुनिश्चित करें कि आप अपनी परियोजनाओं तक पहुंच सकते हैं।
- Firebase कंसोल के ऐप वितरण पृष्ठ में, वह ऐप चुनें जिसे आप वितरित करना चाहते हैं, फिर प्रारंभ करें क्लिक करें.
अपने ऐप को अपलोड करने और इसे परीक्षकों को वितरित करने के लिए
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.apk \ --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 ऐप्स वितरित करने के सर्वोत्तम अभ्यास सीखें।