इस दस्तावेज़ में, Firebase App Distribution और फ़ास्टलेन को इस्तेमाल करने के सबसे सही तरीकों के बारे में बताया गया है. इनकी मदद से, Apple प्लैटफ़ॉर्म की रिलीज़ से पहले वाले टेस्टिंग वर्कफ़्लो को ईको-फ़्रेंडली बनाया जा सकता है. साथ ही, सीआई/सीडी सिस्टम में इसे बार-बार इस्तेमाल किया जा सकता है. इस दस्तावेज़ में, फ़ास्टलेन पर फ़ोकस किया गया है. हालांकि, हम आपको ज़्यादा सुविधाएं देने के लिए, Firebase कंसोल, Firebase सीएलआई, और सार्वजनिक Firebase App Distribution एपीआई के ज़रिए उपलब्ध समाधानों के बारे में भी बताते हैं. हम रिलीज़ और टेस्टर की सीमाओं के बारे में भी बताते हैं, ताकि आप बेहतर अनुभव के लिए पहले से योजना बना सकें.
अगर Android का भी इस्तेमाल किया जा रहा है, तो CI/CD का इस्तेमाल करके, Android ऐप्लिकेशन को क्यूए टेस्टर को डिस्ट्रिब्यूट करने के सबसे सही तरीके देखें.
शुरू करने से पहले
इस दस्तावेज़ में दिए गए सबसे सही तरीकों को लागू करने से पहले, Firebase कंसोल में हर ऐप्लिकेशन के लिए App Distribution को चालू करना न भूलें. अगर आपने App Distribution को चालू नहीं किया है, तो आपको 404 कोड वाली गड़बड़ी का मैसेज दिखेगा.
App Distribution को चालू करने के लिए, यह तरीका अपनाएं:
Firebase कंसोल में, App Distribution पेज खोलें.
अपना iOS ऐप्लिकेशन चुनें.
शुरू करें पर क्लिक करें.
सीआई/सीडी का इस्तेमाल करके, रिलीज़ से पहले के टेस्टिंग वर्कफ़्लो को ऑटोमेट करें
अगर आपको जांच करने वाले लोगों के लिए, अपने-आप ऐप्लिकेशन बनाना और रिलीज़ करना है और CI/CD का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप फ़ास्टलेन का इस्तेमाल करें. दूसरा विकल्प, Firebase सीएलआई का इस्तेमाल करना है. इससे आपको कई तरह के Firebase प्रॉडक्ट को ऐक्सेस करने में मदद मिलती है.
फ़ास्ट लेन का इस्तेमाल करें
fastlane का इस्तेमाल करके, App Distribution को अपनी CI/CD पाइपलाइन में इंटिग्रेट करें. यह एक ओपन-सोर्स टूल है, जो iOS और Android ऐप्लिकेशन को बनाने और रिलीज़ करने की प्रोसेस को ऑटोमेट करता है. टेस्टर के लिए अपने ऐप्लिकेशन के नए वर्शन अपने-आप बनाने और उन्हें डिस्ट्रिब्यूट करने की सुविधा चालू करने पर, यह पक्का किया जा सकता है कि टेस्टर के पास आपके ऐप्लिकेशन का सबसे अप-टू-डेट टेस्ट वर्शन हमेशा उपलब्ध रहे.
App Distribution को fastlane के साथ इंटिग्रेट करने का तरीका जानने के लिए, fastlane का इस्तेमाल करके, टेस्टर को iOS ऐप्लिकेशन उपलब्ध कराना लेख पढ़ें. कोडलैब भी देखें, जिसमें आपको फ़ास्टलेन इंटिग्रेशन की प्रोसेस के बारे में जानकारी मिलती है.
Firebase CLI का इस्तेमाल करना
Firebase CLI टूल का इस्तेमाल करें, जो App Distribution प्रोग्राम के हिसाब से, टेस्टर को बाइन्ड डिस्ट्रिब्यूट करने के लिए उपलब्ध कराता है. किसी बिल्ड के लिए, टेस्टर और रिलीज़ नोट तय किए जा सकते हैं.
ऐप्लिकेशन का Firebase ऐप्लिकेशन आईडी बताकर, अपना सबसे नया iOS बिल्ड test.ipa
डिस्ट्रिब्यूट करें.
इसके लिए, रिलीज़ नोट और टेस्टर के ईमेल वाली फ़ाइल भी जोड़ें:
firebase appdistribution:distribute test.ipa \ --app 1:1234567890:ios:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
अपने बिल्ड को ऑटोमेट करने के लिए, Firebase सीएलआई का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Firebase सीएलआई का इस्तेमाल करके, टेस्टर को iOS ऐप्लिकेशन डिस्ट्रिब्यूट करें देखें.
पुष्टि करने के लिए सेवा क्रेडेंशियल का इस्तेमाल करें
सेवा खातों के साथ App Distribution fastlane प्लग इन या Firebase सीएलआई का इस्तेमाल करें. ये ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का फ़ायदा लेते हैं और सीआई को मैनेज करने में आपकी मदद करते हैं. सेवा खाता एक ऐसा Google खाता है जो उपयोगकर्ताओं की जगह ऐप्लिकेशन को दिखाता है. आपका सीआई सिस्टम, आपके App Distribution वर्कलोड को चलाने के लिए सेवा खातों का इस्तेमाल कर सकता है. ज़्यादा जानने के लिए, सेवा खाते से पुष्टि करना लेख पढ़ें.
अगर वर्कलोड आइडेंटिटी फ़ेडरेशन का इस्तेमाल किया जा रहा है, तो सेवा खाते की कुंजी के बजाय, क्रेडेंशियल कॉन्फ़िगरेशन फ़ाइल जनरेट और इस्तेमाल की जा सकती है.
रिलीज़ की सीमाओं का ध्यान रखें
App Distribution हर ऐप्लिकेशन के लिए ज़्यादा से ज़्यादा 1,000 रिलीज़ का इस्तेमाल किया जा सकता है. इसका मतलब है कि रिलीज़ की सीमा पार करने पर App Distribution, तय सीमा से ज़्यादा पुरानी रिलीज़ अपने-आप मिटा देता है. रिलीज़ की सीमाओं को मैनेज करने का तरीका जानने के लिए, ऐप्लिकेशन रिलीज़ कितने समय तक उपलब्ध रहती हैं? लेख पढ़ें
एक से ज़्यादा रिलीज़ में, टेस्टर का एक ही सेट जोड़ना
अगर आपको रिलीज़ में बड़ी संख्या में टेस्टर जोड़ने हैं, तो App Distribution की बल्क टेस्टर मैनेजमेंट सुविधा का इस्तेमाल करें.
हमारा सुझाव है कि एक ही टेस्टर को कई रिलीज़ में जोड़ने के लिए, ग्रुप का इस्तेमाल करें. ग्रुप, ऐक्सेस कंट्रोल सूची के तौर पर काम करता है. किसी टेस्टर को ग्रुप से हटाने पर, उसके पास उस ग्रुप में डिस्ट्रिब्यूट की गई सभी रिलीज़ का ऐक्सेस नहीं रहेगा. ज़्यादा जानने के लिए, किसी ग्रुप में टेस्टर जोड़ना और हटाना लेख पढ़ें.
अगर कई टेस्टर को मैनेज करना है, तो Firebase कंसोल का इस्तेमाल करके, एक साथ कई टेस्टर जोड़े और मिटाए जा सकते हैं. टेस्टर को अपने-आप जोड़ने और हटाने के लिए, Firebase सीएलआई, फ़ास्टलेन या सार्वजनिक Firebase App Distribution API का इस्तेमाल करें.
टेस्टर की सीमाओं का ध्यान रखें
App Distribution, टेस्टर की संख्या को सीमित करता है, ताकि उसे Firebase प्रोजेक्ट या App Distribution ग्रुप में जोड़ा जा सके. इन सीमाओं से ज़्यादा टेस्टर जोड़ने पर, आपके पास अपने ऐप्लिकेशन को अन्य टेस्टर को डिस्ट्रिब्यूट करने का विकल्प नहीं होगा. टेस्टर की संख्या से जुड़ी सीमाओं के बारे में ज़्यादा जानने के लिए, क्या मेरे ऐप्लिकेशन में टेस्टर जोड़ने की सीमाएं हैं? लेख पढ़ें
नए iOS टेस्टर डिवाइसों को मैनेज करना और उन्हें अपने-आप जोड़ना
App Distribution, iOS टेस्टर के तौर पर इस्तेमाल किए जाने वाले अन्य डिवाइसों को रजिस्टर करने में आपकी मदद करता है. इसके लिए, यह आपको ईमेल या CSV फ़ाइलों के ज़रिए, iOS टेस्टर के तौर पर इस्तेमाल किए जाने वाले नए डिवाइसों के बारे में जानकारी देता है. इससे, Apple Developer Portal में iOS टेस्टर के तौर पर इस्तेमाल किए जाने वाले डिवाइसों को मैनेज करने में मदद मिलती है. ज़्यादा जानने के लिए, CSV फ़ाइलों से टेस्टर इंपोर्ट करना देखें. प्रोग्राम के हिसाब से, fastlane का इस्तेमाल करके नए डिवाइसों को एक्सपोर्ट भी किया जा सकता है.
Fastlane ऐक्शन को सेट अप करने का तरीका जानने के लिए, App Distribution और Fastlane की मदद से, रिलीज़ से पहले के iOS बिल्ड को तेज़ी से डिस्ट्रिब्यूट करना लेख पढ़ें. यह ऐक्शन, UDID को अपने-आप डाउनलोड करता है, उन्हें Apple Developer Console में जोड़ता है, और फिर ऐप्लिकेशन को फिर से बनाकर उसे डिस्ट्रिब्यूट करता है.
टेस्टर के तौर पर शामिल होने के लिए, लोगों को खुद रजिस्टर करने की सुविधा चालू करना
हमारा सुझाव है कि टेस्टर को अपना ऐप्लिकेशन आसानी से उपलब्ध कराने के लिए, न्योते के लिंक का इस्तेमाल करें. न्योते का लिंक एक यूनीक यूआरएल होता है. इसकी मदद से, टेस्टर अपने ईमेल पते डालकर किसी ऐप्लिकेशन की जांच कर सकते हैं. इससे उपयोगकर्ताओं को ऐप्लिकेशन टेस्टर की सूची में खुद को जोड़ने की सुविधा मिलती है. इससे, इंटरनल टेस्टिंग बेस को आसानी से बढ़ाने में मदद मिलती है.
न्योते के लिंक के इस्तेमाल के उदाहरणों में कंपनी के dogfood प्रोग्राम, बड़ी QA टीमों वाले संगठन, और ऐसे डेवलपर ग्रुप शामिल हैं जिन्हें अलग-अलग क्लाइंट, टेस्टर ऐक्सेस को कंट्रोल कर सकें.
हमारा सुझाव है कि आप किसी ग्रुप के लिए न्योते का लिंक बनाएं. न्योते के लिंक का इस्तेमाल करके साइन अप करने वाला टेस्टर, बाद वाली रिलीज़ में अपने-आप जुड़ जाता है.
ज़्यादा जानने के लिए, न्योते के लिंक बनाना और किसी ग्रुप में टेस्टर जोड़ना और हटाना लेख पढ़ें.
पक्का करें कि टेस्टर उस वर्शन की जांच कर रहे हैं जो आपके लिए अहम है
नया वर्शन अपलोड किए जाने पर, आपके टेस्टर को ईमेल से इसकी सूचना दी जाती है. इस सूचना को शामिल करने के लिए, इन सुविधाओं का इस्तेमाल किया जा सकता है – रिलीज़ के लिंक और इन-ऐप्लिकेशन अलर्ट – ताकि यह पक्का हो सके कि आपके टेस्टर, ऐप्लिकेशन के उस खास वर्शन की जांच कर रहे हैं जो आपके लिए अहम है:
रिलीज़ के लिंक: इस सुविधा का इस्तेमाल तब करें, जब आपको टेस्टर के साथ कोई खास वर्शन शेयर करना हो. रिलीज़ लिंक को इस्तेमाल करने का तरीका जानने के लिए, Firebase कंसोल का इस्तेमाल करके, टेस्टर को iOS ऐप्लिकेशन उपलब्ध कराना देखें. ये लिंक, Firebase और fastlane कमांड-लाइन (सीएलआई) टूल के साथ भी उपलब्ध हैं. इनका इस्तेमाल, बिल्ड ऑटोमेशन टूल के साथ किया जा सकता है.
इन-ऐप्लिकेशन सूचनाएं: इन सूचनाओं का इस्तेमाल तब करें, जब आपको यह पक्का करना हो कि आपके टेस्टर, ऐप्लिकेशन के नए वर्शन की जांच कर रहे हैं. Firebase App Distribution iOS SDK टूल को इंटिग्रेट करके, ऐप्लिकेशन के नए बिल्ड उपलब्ध होने पर, सीधे तौर पर टेस्टर को ऐप्लिकेशन में सूचनाएं दिखाई जा सकती हैं. इन-ऐप्लिकेशन सूचनाएं जोड़ने का तरीका जानने के लिए, टेस्टर को नए बिल्ड के बारे में सूचना देना लेख पढ़ें.
कंपनी छोड़ने वाले टेस्टर का ऐक्सेस अपने-आप हटने की सुविधा
सीआई/सीडी का इंटरनल टेस्टिंग फ़्लो चालू होने के बाद, आपको यह पक्का करना होगा कि कंपनी छोड़ने वाले लोगों के पास आपके इंटरनल बिल्ड का ऐक्सेस न रहे. टेस्टर के लिए, बिल्ड का ऐक्सेस मैनेज करने में आपकी मदद करने के लिए, App Distribution ये विकल्प उपलब्ध कराता है:
fastlane: अपनी Fastfile फ़ाइल का इस्तेमाल करें या सीधे fastlane कार्रवाइयां चलाएं. टेस्टर हटाने के लिए, fastlane का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, fastlane का इस्तेमाल करके, टेस्टर को iOS ऐप्लिकेशन उपलब्ध कराना लेख पढ़ें.
सार्वजनिक Firebase App Distribution API:
testers.batchRemove
एंडपॉइंट का इस्तेमाल करें.