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

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

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

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

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

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

  1. Firebase कंसोल में, App Distribution पेज खोलें.

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

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

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

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

fastlane का इस्तेमाल करना

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

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

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

App Distribution के उपलब्ध कराए गए Firebase सीएलआई टूल का इस्तेमाल करके, प्रोग्राम के हिसाब से टेस्टर को बिल्ड उपलब्ध कराएं. किसी बिल्ड के लिए, टेस्टर और रिलीज़ नोट तय किए जा सकते हैं.

ऐप्लिकेशन का 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 वर्कलोड चला सकता है. ज़्यादा जानने के लिए, सेवा खाते से पुष्टि करना लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

न्योते के लिंक का इस्तेमाल, कंपनी के डॉगफ़ूड प्रोग्राम, बड़ी QA टीमों वाले संगठनों, और डेवलपर ग्रुप के लिए किया जाता है. ये ग्रुप चाहते हैं कि उनके क्लाइंट, टेस्टर के ऐक्सेस को कंट्रोल कर सकें.

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

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

पक्का करें कि टेस्टर, आपके चुने गए वर्शन की जांच कर रहे हों

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

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

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

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

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