Firebase सीएलआई का इस्तेमाल करके, जांच करने वाले लोगों को iOS ऐप्लिकेशन उपलब्ध कराएं

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

अपने ऐप्लिकेशन को टेस्टर के साथ डिस्ट्रिब्यूट करने के लिए, Firebase सीएलआई का इस्तेमाल करके IPA फ़ाइल अपलोड करें:

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

  2. appdistribution:distribute निर्देश चलाकर, अपने ऐप्लिकेशन को अपलोड करें और उसे टेस्टर के साथ डिस्ट्रिब्यूट करें. डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के लिए, इन पैरामीटर का इस्तेमाल करें:

    appdistribution:distribute के विकल्प
    --app

    ज़रूरी है: आपके ऐप्लिकेशन का Firebase ऐप्लिकेशन आईडी. ऐप्लिकेशन आईडी, Firebase कंसोल में, सामान्य सेटिंग वाले पेज पर देखा जा सकता है.

    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    यह एक रीफ़्रेश टोकन है, जो सीआई एनवायरमेंट की पुष्टि करने पर Firebase सीएलआई की मदद से दिखता है. ज़्यादा जानकारी के लिए, सीआई सिस्टम के साथ सीएलआई का इस्तेमाल करना लेख पढ़ें. 

    --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

    यह एक फ़्लैग है. इसे वर्बोस लॉग आउटपुट प्रिंट करने के लिए शामिल किया जा सकता है.
    --test-devices
    --test-devices-file

    वे टेस्ट डिवाइस जिन पर आपको App Testing एजेंट के टेस्ट चलाने हैं.

    टेस्ट डिवाइस को सेमी-कॉलन लगाकर अलग किए गए डिवाइस की खास जानकारी की सूची के तौर पर तय किया जा सकता है:

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait"

    इसके अलावा, सादे टेक्स्ट वाली उस फ़ाइल का पाथ तय किया जा सकता है जिसमें सेमी-कॉलन लगाकर अलग किए गए टेस्ट डिवाइस की सूची मौजूद हो:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    App Testing एजेंट के टेस्ट के दौरान, अपने-आप लॉगिन करने के लिए इस्तेमाल किया जाने वाला उपयोगकर्ता नाम.
    --test-password
    --test-password-file

    App Testing एजेंट के टेस्ट के दौरान, अपने-आप लॉगिन करने के लिए इस्तेमाल किया जाने वाला पासवर्ड.

    इसके अलावा, सादे टेक्स्ट वाली उस फ़ाइल का पाथ तय किया जा सकता है जिसमें पासवर्ड मौजूद हो:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    App Testing एजेंट के टेस्ट के दौरान, अपने-आप लॉगिन करने के लिए इस्तेमाल किए जाने वाले उपयोगकर्ता नाम वाले फ़ील्ड का संसाधन नाम.
    --test-password-resource

    App Testing एजेंट के टेस्ट के दौरान, अपने-आप लॉगिन करने के लिए इस्तेमाल किए जाने वाले पासवर्ड वाले फ़ील्ड का संसाधन नाम.
    --test-non-blocking

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

    उदाहरण के लिए:

    firebase appdistribution:distribute test.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    रिलीज़ अपलोड होने के बाद, Firebase सीएलआई ये लिंक आउटपुट करता है. इन लिंक की मदद से, बाइनरी मैनेज की जा सकती हैं. साथ ही, यह पक्का किया जा सकता है कि टेस्टर और अन्य डेवलपर के पास सही रिलीज़ हो:

    • firebase_console_uri - यह कंसोल का एक लिंक है. इस पर एक रिलीज़ दिखती है.Firebase इस लिंक को अपने संगठन के अन्य डेवलपर के साथ शेयर किया जा सकता है.
    • testing_uri - यह टेस्टर के अनुभव (iOS वेब क्लिप) में रिलीज़ का एक लिंक है. इसकी मदद से, टेस्टर रिलीज़ नोट देख सकते हैं और अपने डिवाइस पर ऐप्लिकेशन इंस्टॉल कर सकते हैं. लिंक का इस्तेमाल करने के लिए, टेस्टर के पास रिलीज़ का ऐक्सेस होना ज़रूरी है.
    • binary_download_uri - यह एक साइन किया गया लिंक है. इससे ऐप्लिकेशन की बाइनरी (IPA फ़ाइल) सीधे डाउनलोड और इंस्टॉल हो जाती है. यह लिंक एक घंटे बाद काम करना बंद कर देता है.

    टेस्टर और ग्रुप मैनेज करना

    रिलीज़ डिस्ट्रिब्यूट करने के अलावा, 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.

    अगर आपके पास ज़्यादा टेस्टर हैं, तो ग्रुप का इस्तेमाल करने पर विचार करें: अपने Firebase प्रोजेक्ट में ग्रुप बनाने या मिटाने के लिए, appdistribution:group:create और appdistribution:group:delete का इस्तेमाल किया जा सकता है.

    --group-alias निर्देश के लिए, ग्रुप तय करने के लिए appdistribution:testers:add और appdistribution:testers:remove का इस्तेमाल करें.

    उदाहरण के लिए:

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

बिल्ड डिस्ट्रिब्यूट करने के बाद, यह App Distribution डैशबोर्ड में Firebase कंसोल के 150 दिनों (पांच महीने) तक उपलब्ध रहता है. बिल्ड की समयसीमा खत्म होने में 30 दिन बाकी रहने पर, कंसोल और टेस्टर के टेस्ट डिवाइस पर, बिल्ड की सूची में समयसीमा खत्म होने की सूचना दिखती है.

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

टेस्टर के पास, ऐप्लिकेशन की जांच करने का न्योता स्वीकार करने के लिए 30 दिन होते हैं. इसके बाद, न्योते की समयसीमा खत्म हो जाती है. न्योते की समयसीमा खत्म होने में पांच दिन बाकी रहने पर, Firebase कंसोल में रिलीज़ पर मौजूद टेस्टर के बगल में, समयसीमा खत्म होने की सूचना दिखती है. टेस्टर की लाइन में मौजूद ड्रॉप-डाउन मेन्यू का इस्तेमाल करके, न्योता फिर से भेजकर उसे रिन्यू किया जा सकता है.

अगले चरण