सीआई/सीडी और फ़ास्टलेन का इस्तेमाल करके, QA जांच करने वाले लोगों को Apple ऐप्लिकेशन उपलब्ध कराने के सबसे सही तरीके

इस दस्तावेज़ में Firebase App Distribution और फ़ास्टलेन इस्तेमाल करने के सबसे सही तरीके बताए गए हैं. इनकी मदद से, Apple प्लैटफ़ॉर्म की रिलीज़ से पहले वाले टेस्टिंग वर्कफ़्लो को ईको-फ़्रेंडली बनाया जा सकता है. साथ ही, उसे सीआई/सीडी एनवायरमेंट में बार-बार इस्तेमाल किया जा सकता है. यह दस्तावेज़ फ़ास्टलेन पर आधारित है. हालांकि, हम Firebase कंसोल, Firebase सीएलआई, और सार्वजनिक Firebase App Distribution API के ज़रिए उपलब्ध समाधानों के बारे में भी बताते हैं, ताकि आपको ज़्यादा सुविधाएं मिल सकें. हम रिलीज़ और टेस्टर की सीमाओं के बारे में भी बताते हैं, ताकि आप बेहतर अनुभव पाने के लिए, पहले से प्लान बना सकें.

अगर आपके पास Android ऐप्लिकेशन है, तो CI/CD का इस्तेमाल करके, QA जांच करने वाले लोगों को Android ऐप्लिकेशन उपलब्ध कराने के सबसे सही तरीके लेख पढ़ें.

वेब कंटेनर इंस्टॉल करने से पहले

इस दस्तावेज़ में दिए गए सबसे सही तरीके लागू करने से पहले, Firebase कंसोल में हर ऐप्लिकेशन के लिए ऐप्लिकेशन डिस्ट्रिब्यूशन की सुविधा चालू करना न भूलें. अगर आपने ऐप्लिकेशन डिस्ट्रिब्यूशन की सुविधा चालू नहीं की है, तो आपको 404 गड़बड़ी दिखेगी.

App Distribution चालू करने के लिए, यह तरीका अपनाएं:

  1. Firebase कंसोल में, ऐप्लिकेशन डिस्ट्रिब्यूशन पेज खोलें.

  2. अपना iOS ऐप्लिकेशन चुनें.

  3. शुरू करें पर क्लिक करें.

सीआई/सीडी का इस्तेमाल करके, रिलीज़ से पहले के टेस्टिंग वर्कफ़्लो को ऑटोमेट करें

अगर आपको जांच करने वाले लोगों के लिए, अपने-आप ऐप्लिकेशन बनाना और रिलीज़ करना है और CI/CD का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप फ़ास्टलेन का इस्तेमाल करें. इसके अलावा, Firebase सीएलआई का इस्तेमाल भी किया जा सकता है. इससे आपको कई तरह के Firebase प्रॉडक्ट ऐक्सेस करने में मदद मिलती है.

फ़ास्ट लेन का इस्तेमाल करें

फ़ास्टलेन की मदद से, App Distribution को CI/CD पाइपलाइन में इंटिग्रेट करें. फ़ास्टलेन एक ओपन सोर्स टूल है. यह अपने-आप iOS और Android ऐप्लिकेशन बनाने और रिलीज़ करने में मदद करता है. टेस्टर को अपने-आप नई रिलीज़ बनाने और डिस्ट्रिब्यूट करने से, आपको यह पक्का करने में मदद मिलती है कि टेस्टर के पास आपके ऐप्लिकेशन का सबसे अप-टू-डेट टेस्ट वर्शन हो.

फ़ास्टलेन के साथ App Distribution को इंटिग्रेट करने का तरीका जानने के लिए, फ़ास्टलेन का इस्तेमाल करके टेस्टर को iOS ऐप्लिकेशन उपलब्ध कराएं देखें. एक कोडलैब भी देखें, जो आपको फ़ास्ट लेन इंटिग्रेशन की प्रोसेस के बारे में बताता है.

Firebase सीएलआई का इस्तेमाल करना

उन Firebase सीएलआई टूल का इस्तेमाल करें जिन्हें 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 से जुड़े वर्कलोड को चलाने के लिए, आपका सीआई सिस्टम, सेवा खातों का इस्तेमाल कर सकता है. ज़्यादा जानने के लिए, सेवा खाते से पुष्टि करें देखें.

अगर वर्कलोड आइडेंटिटी फ़ेडरेशन का इस्तेमाल किया जा रहा है, तो आपके पास सेवा खाता कुंजी के बजाय, क्रेडेंशियल कॉन्फ़िगरेशन फ़ाइल जनरेट करने और उसका इस्तेमाल करने का विकल्प होता है.

रिलीज़ की सीमाओं का ध्यान रखना

ऐप्लिकेशन डिस्ट्रिब्यूशन, हर ऐप्लिकेशन के लिए ज़्यादा से ज़्यादा 1,000 रिलीज़ की सुविधा देता है. इसका मतलब है कि रिलीज़ की सीमा पार करने पर, App Distribution आपकी तय की गई सीमा से ज़्यादा पुरानी रिलीज़ को अपने-आप मिटा देगा. रिलीज़ की सीमाओं को मैनेज करने का तरीका जानने के लिए, देखें ऐप्लिकेशन की रिलीज़ कितने समय के लिए उपलब्ध होती हैं?

एक से ज़्यादा रिलीज़ में, टेस्टर का एक ही सेट जोड़ना

अगर आपको अपनी रिलीज़ में बड़ी संख्या में टेस्टर जोड़ना है, तो App Distribution की बल्क टेस्टर मैनेजमेंट सुविधा का इस्तेमाल करें.

हमारा सुझाव है कि आप एक से ज़्यादा रिलीज़ में एक ही टेस्टर को जोड़ने के लिए, ग्रुप का इस्तेमाल करें. ग्रुप एक ऐक्सेस कंट्रोल सूची के तौर पर काम करता है. जब ग्रुप से किसी टेस्टर को हटाया जाता है, तो वह उस ग्रुप को दी गई सभी रिलीज़ का ऐक्सेस खो देता है. ज़्यादा जानने के लिए, ग्रुप में टेस्टर जोड़ना और हटाना देखें.

अगर आपको कई टेस्टर मैनेज करने हैं, तो Firebase कंसोल का इस्तेमाल करके, एक साथ कई टेस्टर जोड़े और मिटाए जा सकते हैं. टेस्टर को अपने-आप जोड़ने और हटाने के लिए, Firebase सीएलआई, फ़ास्टलेन या सार्वजनिक Firebase App Distribution API का इस्तेमाल करें.

टेस्टर की तय सीमाओं का ध्यान रखें

App Distribution टेस्टर की संख्या को सीमित करता है. इसे Firebase प्रोजेक्ट या App Distribution ग्रुप में जोड़ा जा सकता है. अगर इन सीमाओं को पार कर लिया जाता है, तो अन्य टेस्टर को अपना ऐप्लिकेशन उपलब्ध नहीं कराया जा सकेगा. टेस्टर की सीमाओं के बारे में ज़्यादा जानने के लिए, क्या मेरे ऐप्लिकेशन में टेस्टर जोड़ने की कोई सीमा है? सेक्शन देखें

नए iOS टेस्टर डिवाइसों को अपने-आप जोड़ना और मैनेज करना

अतिरिक्त iOS टेस्टर डिवाइसों को रजिस्टर करने में आपकी मदद करने के लिए, App Distribution आपको Apple Developer Portal पर अपने iOS टेस्टर डिवाइसों को मैनेज करने में मदद करता है. इसके लिए, यह आपको ईमेल या CSV फ़ाइलों के ज़रिए नए टेस्टर iOS डिवाइसों के बारे में जानकारी देता है. ज़्यादा जानने के लिए, CSV फ़ाइलों से टेस्टर इंपोर्ट करना देखें. आपके पास प्रोग्राम बनाकर, फ़ास्टलेन का इस्तेमाल करके नए डिवाइसों को एक्सपोर्ट करने का भी विकल्प होता है.

यूडीआईडी को अपने-आप नीचे ले जाने, उन्हें Apple Developer Console में जोड़ने, और ऐप्लिकेशन को फिर से बनाकर उसे उपलब्ध कराने का तरीका जानने के लिए, App Distribution और फ़ास्टलेन की मदद से रिलीज़ से पहले के iOS बिल्ड तेज़ी से डिस्ट्रिब्यूट करें सेक्शन देखें.

संभावित टेस्टर को टेस्टिंग के लिए खुद रजिस्ट्रेशन करने की सुविधा दें

हमारा सुझाव है कि टेस्टर को अपना ऐप्लिकेशन आसानी से उपलब्ध कराने के लिए, न्योते के लिंक का इस्तेमाल करें. न्योते का लिंक एक यूनीक यूआरएल होता है. इसकी मदद से, टेस्टर अपने ईमेल पते डालकर किसी ऐप्लिकेशन की जांच कर सकते हैं. इससे लोगों को ऐप्लिकेशन टेस्टर की सूची में खुद को जोड़ने की सुविधा मिलती है. इससे, इंटरनल टेस्टिंग बेस को आसानी से बढ़ाने में मदद मिलती है.

न्योते के लिंक के इस्तेमाल के उदाहरणों में कंपनी के dogfood प्रोग्राम, बड़ी QA टीम वाले संगठन, और ऐसे डेवलपर ग्रुप शामिल हैं जिन्हें अलग-अलग क्लाइंट, टेस्टर ऐक्सेस को कंट्रोल कर सकें.

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

ज़्यादा जानने के लिए, न्योते के लिंक बनाना और टेस्टर को ग्रुप में जोड़ना और हटाना लेख पढ़ें.

पक्का करें कि टेस्टर उस वर्शन की जांच कर रहे हैं जो आपके लिए अहम है

नया वर्शन अपलोड किए जाने पर, आपके टेस्टर को ईमेल से इसकी सूचना दी जाती है. इस सूचना को जोड़ने के लिए, इन सुविधाओं – रिलीज़ लिंक और इन-ऐप्लिकेशन अलर्ट – का इस्तेमाल किया जा सकता है. इससे यह पक्का किया जा सकता है कि आपके टेस्टर, ऐप्लिकेशन के उस खास वर्शन की जांच कर रहे हैं जो आपके लिए अहम है:

  • रिलीज़ लिंक: इस सुविधा का इस्तेमाल तब करें, जब आपको टेस्टर के साथ कोई खास वर्शन शेयर करना हो. रिलीज़ लिंक का इस्तेमाल करने का तरीका जानने के लिए, Firebase कंसोल का इस्तेमाल करके जांच करने वाले लोगों को iOS ऐप्लिकेशन उपलब्ध कराना देखें. ये लिंक हमारे Firebase और फ़ास्टलेन कमांड-लाइन (सीएलआई) टूल के साथ भी उपलब्ध हैं. इनका इस्तेमाल आपके बिल्ड ऑटोमेशन टूल के साथ किया जाता है.

  • इन-ऐप्लिकेशन सूचनाएं: इन सूचनाओं का इस्तेमाल तब करें, जब आपको यह पक्का करना हो कि आपके टेस्टर आपके ऐप्लिकेशन के सबसे नए वर्शन की जांच कर रहे हैं. Firebase App Distribution iOS SDK टूल इंटीग्रेट करके, ऐप्लिकेशन के नए बिल्ड उपलब्ध होने पर सीधे तौर पर टेस्टर को ऐप्लिकेशन में सूचनाएं दिखाई जा सकती हैं. इन-ऐप्लिकेशन सूचनाएं जोड़ने का तरीका जानने के लिए, टेस्टर को नए बिल्ड के बारे में सूचना दें देखें.

कंपनी छोड़ने वाले टेस्टर के लिए, ऐक्सेस अपने-आप हटाने की सुविधा

CI/CD की इंटरनल टेस्टिंग का फ़्लो तैयार होने के बाद, आपको यह पक्का करना होगा कि कंपनी को छोड़ने वाले लोग, अब आपके इंटरनल बिल्ड का ऐक्सेस न रख पाएं. बिल्ड के टेस्टर का ऐक्सेस मैनेज करने में आपकी मदद करने के लिए, App Distribution ये विकल्प देता है: