अतिरिक्त iOS डिवाइसों को रजिस्टर करें

अगर आपको App Distribution का इस्तेमाल करके, ऐड हॉक iOS बिल्ड डिस्ट्रिब्यूट करने हैं, तो आपको अपने टेस्टर के डिवाइसों को रजिस्टर करने के लिए, इस गाइड का पालन करना होगा. एडहॉक बिल्ड ऐसा बिल्ड होता है जिस पर एंटरप्राइज़ प्रोफ़ाइल से हस्ताक्षर नहीं किए गए होते हैं. कोई डिवाइस सिर्फ़ तब ऐड हॉक बिल्ड इंस्टॉल कर सकता है, जब डिवाइस का यूनीक डिवाइस आइडेंटिफ़ायर (यूडीआईडी), बिल्ड की प्रोविज़निंग प्रोफ़ाइल में शामिल हो.

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

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

यूडीआईडी को मैन्युअल तरीके से एक्सपोर्ट करना

  1. अपने Apple डेवलपर पोर्टल में डिवाइस जोड़ें.
    • पहला विकल्प: डिवाइस के यूडीआईडी को CSV फ़ाइल के तौर पर इंपोर्ट करें.

      CSV फ़ाइल डाउनलोड करने के लिए, App Distribution डैशबोर्ड के टेस्टर और ग्रुप टैब में जाकर, सभी टेस्टर को चुनें. इसके बाद, Apple UDID एक्सपोर्ट करें पर क्लिक करें. इसके बाद, Register Multiple Devices विकल्प का इस्तेमाल करके, फ़ाइल को अपने Apple डेवलपर खाते में इंपोर्ट करें. ज़्यादा जानने के लिए, रजिस्टर किए गए डिवाइसों पर अपना ऐप्लिकेशन उपलब्ध कराना लेख पढ़ें.

      ध्यान दें कि Apple डेवलपर खाते से, हर साल सिर्फ़ कुछ डिवाइसों का डेटा इंपोर्ट किया जा सकता है.

    • दूसरा विकल्प: ईमेल से यूडीआईडी इकट्ठा करें और उन्हें डालें.

      Apple Developer Portal के डिवाइस जोड़ें पेज पर, आपको मिले ईमेल में दिया गया नया यूडीआईडी रजिस्टर करें.

  2. रजिस्टर किए गए डिवाइसों को अपनी प्रोविज़निंग प्रोफ़ाइल में जोड़ें.
  3. प्रोविज़निंग प्रोफ़ाइल डाउनलोड करें और उसका इस्तेमाल करके, अपना ऐप्लिकेशन फिर से बनाएं. अगर आपको सिर्फ़ रजिस्टर किए गए डिवाइसों को अपडेट करने के लिए ऐप्लिकेशन फिर से बनाना है, तो बिल्ड नंबर या वर्शन अपडेट न करें.
  4. Firebase कंसोल या सीएलआई से, अपने ऐप्लिकेशन को फिर से डिस्ट्रिब्यूट करें. अगर आपने वर्शन, बिल्ड नंबर या ऐप्लिकेशन के कोड में बदलाव नहीं किया है, तो App Distribution नई रिलीज़ नहीं बनाएगा. साथ ही, टेस्टर को इसकी सूचना नहीं देगा. अगर आपने एक ही बिल्ड नंबर और वर्शन वाली कोई बिल्ड पहले ही डिस्ट्रिब्यूट कर दी है, तो नए डिवाइसों के लिए रजिस्टर करने वाले उपयोगकर्ताओं को ही सूचना वाले ईमेल मिलेंगे.

fastlane का इस्तेमाल करके, प्रोग्राम के हिसाब से यूडीडीआई एक्सपोर्ट करना

  1. fastlane से, टेस्टर डिवाइस के सभी यूडीआईडी को CSV फ़ाइल के तौर पर एक्सपोर्ट करें. उदाहरण के लिए, नई download_udids लेन बनाएं और उसे चलाएं:

    lane :download_udids do
        firebase_app_distribution_get_udids(
            app: "<your Firebase app ID>",
            output_file: "<path to output file>",
        )
    end
    
  2. Register Multiple Devices विकल्प का इस्तेमाल करके, UDID को अपने Apple डेवलपर खाते में इंपोर्ट करें. ज़्यादा जानने के लिए, Apple के दस्तावेज़ देखें. ध्यान दें कि आपका Apple डेवलपर खाता, आपको हर साल सिर्फ़ कुछ डिवाइसों को इंपोर्ट करने की अनुमति दे सकता है.

  3. रजिस्टर किए गए डिवाइसों को अपनी प्रोविज़निंग प्रोफ़ाइल {: .external} में जोड़ें.

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

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

सूचनाएं पाना

डिफ़ॉल्ट सूचनाएं पाना

डिफ़ॉल्ट रूप से, Firebase, ईमेल का इस्तेमाल करके नए iOS डिवाइसों के रजिस्ट्रेशन के लिए App Distribution सूचनाएं भेज सकता है.

डिफ़ॉल्ट तरीके का इस्तेमाल करके App Distribution से जुड़ी सूचनाएं पाने के लिए, आपके पास firebase.projects.update की अनुमति होनी चाहिए. इन भूमिकाओं के लिए, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है: Firebase एडमिन या प्रोजेक्ट का मालिक या एडिटर.

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

अपने खाते के लिए सूचनाएं पाने की सुविधा चालू या बंद करना

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

App Distribution सूचनाएं पाने की सुविधा चालू या बंद करने के लिए, यह तरीका अपनाएं:

  1. Firebase कंसोल में, सबसे ऊपर दाएं कोने में, Firebase सूचनाएं पर जाएं.
  2. इसके बाद, सेटिंग पर जाएं और App Distribution सूचनाओं के लिए, खाते की प्राथमिकता सेट करें.

तीसरे पक्ष की सेवाओं के लिए, सूचना पाने की बेहतर सुविधा सेट अप करना

Cloud Functions for Firebase का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर App Distribution सूचनाएं भी भेजी जा सकती हैं. उदाहरण के लिए, एक ऐसा फ़ंक्शन लिखा जा सकता है जो नए iOS डिवाइस के रजिस्ट्रेशन के लिए सूचना देने वाले इवेंट को कैप्चर करता है. साथ ही, सूचना की जानकारी को तीसरे पक्ष की सेवा पर पोस्ट करता है. जैसे, Discord, Slack या Jira.

नए iOS टेस्टर को पूरी तरह से अपने-आप शामिल करने के लिए, एक ऐसा फ़ंक्शन लिखा जा सकता है जो आपके ऐप्लिकेशन की प्रोविज़निंग प्रोफ़ाइल में नए iOS डिवाइस का यूडीआईडी जोड़ता है, ऐप्लिकेशन को फिर से बनाता है, और अपडेट की गई प्रोविज़निंग प्रोफ़ाइल के साथ ऐप्लिकेशन को फिर से डिस्ट्रिब्यूट करता है.

Cloud Functions for Firebase का इस्तेमाल करके, सूचना पाने की बेहतर सुविधाएं सेट अप करने के लिए, यह तरीका अपनाएं:

  1. Firebase के लिए Cloud Functions सेट अप करें. इसमें ये काम शामिल हैं:

    1. Node.js या Python के लिए डेवलपमेंट एनवायरमेंट सेट अप करें.
    2. Firebase सीएलआई को इंस्टॉल करें और उसमें साइन इन करें.
    3. Firebase सीएलआई का इस्तेमाल करके, Cloud Functions for Firebase को शुरू करें.
  2. एक फ़ंक्शन लिखें और उसे डिप्लॉय करें. यह फ़ंक्शन, App Distribution से सूचना वाले इवेंट को कैप्चर करता है और इवेंट के पेलोड को मैनेज करता है. उदाहरण के लिए, सूचना की जानकारी को Discord पर मैसेज के तौर पर पोस्ट करता है.

कैप्चर किए जा सकने वाले सभी सूचना इवेंट के बारे में जानने के लिए, App Distribution सूचनाओं के लिए रेफ़रंस दस्तावेज़ पर जाएं.

अगले चरण