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 कंसोल में रिलीज़ पर मौजूद टेस्टर के बगल में, समयसीमा खत्म होने की सूचना दिखती है. टेस्टर की लाइन में मौजूद ड्रॉप-डाउन मेन्यू का इस्तेमाल करके, न्योता फिर से भेजकर उसे रिन्यू किया जा सकता है.

अगले चरण