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

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

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

  1. अगर आपने पहले से ही Apple प्रोजेक्ट में Firebase नहीं जोड़ा है, तो उसे जोड़ें.

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

  2. App Distribution पेज Firebase कंसोल का खोलें. प्रॉम्प्ट मिलने पर, अपना Firebase प्रोजेक्ट चुनें. इसके बाद, ऐप्लिकेशन स्विचर का इस्तेमाल करके अपना ऐप्लिकेशन चुनें और शुरू करें पर क्लिक करें.

पहला चरण. टेस्टर के साथ अपना ऐप्लिकेशन डिस्ट्रिब्यूट करना

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

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

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

    appdistribution:distribute options
    --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 का इस्तेमाल किया जा सकता है.

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

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

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

अगले चरण