Firebase एक्सटेंशन इंस्टॉल करना

आप Firebase कंसोल, Firebase CLI (कमांड-लाइन इंटरफ़ेस) या अपने-आप जनरेट होने वाले SDK टूल का इस्तेमाल करके, Firebase के किसी भी आधिकारिक एक्सटेंशन को इंस्टॉल (और मैनेज) कर सकते हैं.FirebaseFirebaseFirebase

पक्का करें कि आपने हर इंस्टॉलेशन के तरीके के लिए, काम करने वाले ऐक्शन में अंतर की समीक्षा कर ली हो.



एक्सटेंशन इंस्टॉल या मैनेज करने के लिए, आपको इनमें से कोई एक रोल असाइन किया जाना चाहिए: मालिक या एडिटर या Firebase का एडमिन.

किसी एक्सटेंशन को इंस्टॉल करने के लिए, आपका प्रोजेक्ट Blaze (इस्तेमाल के हिसाब से पेमेंट करें) प्लान पर होना चाहिए. एक्सटेंशन इंस्टॉल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, Firebase सेवाओं या Cloud Secret Manager जैसी Cloud सेवाओं का इस्तेमाल करने के लिए शुल्क लिया जा सकता है. ऐसा तब होता है, जब आपका इस्तेमाल, सेवाओं के मुफ़्त टियर से ज़्यादा हो जाता है.

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

अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने प्रोजेक्ट में Firebase जोड़ें और अपने Firebase प्रोजेक्ट को Blaze (इस्तेमाल के हिसाब से पेमेंट करें) प्लान पर अपग्रेड करें.

पहला चरण: किसी एक्सटेंशन के बारे में ज़्यादा जानकारी देखना

यह चरण ज़रूरी नहीं है, लेकिन हमारा सुझाव है कि इसे पूरा करें.

हमारा सुझाव है कि Firebase Extension इंस्टॉल करने से पहले, आप एक्सटेंशन के बारे में ज़्यादा जानकारी देखें. इसमें ये चीज़ें शामिल हैं:

  • एक्सटेंशन कैसे काम करता है, इंस्टॉलेशन से पहले किए जाने वाले टास्क, और एक्सटेंशन के बारे में जानकारी
  • पहचान से जुड़ी सामान्य जानकारी और ब्यौरा
  • एक्सटेंशन के टास्क के लिए बिलिंग खाते की ज़रूरत है या नहीं
  • Google सेवाएं (एपीआई) और ऐक्सेस रोल ऑपरेशन के लिए ज़रूरी हैं
  • एक्सटेंशन के लिए बनाए गए संसाधन (जैसे, फ़ंक्शन)
  • उपयोगकर्ता के हिसाब से कॉन्फ़िगर किए जा सकने वाले पैरामीटर की जानकारी

किसी एक्सटेंशन के बारे में ज़्यादा जानकारी देखने के लिए:

  1. Extensions Hub में, आधिकारिक Firebase एक्सटेंशन ब्राउज़ करें.

  2. किसी एक्सटेंशन के कार्ड पर क्लिक करके:

दूसरा चरण: एक्सटेंशन इंस्टॉल करना

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

  1. Extensions Hub में, आधिकारिक Firebase एक्सटेंशन ब्राउज़ करें.

  2. किसी एक्सटेंशन के कार्ड पर क्लिक करें. इसके बाद, एक्सटेंशन के बारे में ज़्यादा जानकारी देखें. इसमें इस्तेमाल के खास निर्देश और इंस्टॉलेशन से पहले किए जाने वाले टास्क शामिल हो सकते हैं.

  3. इंस्टॉल करें पर क्लिक करें. इसके बाद, एक्सटेंशन इंस्टॉल करने के लिए स्क्रीन पर दिए गए निर्देशों का पालन करें.

तीसरा चरण: इंस्टॉलेशन के बाद का सेटअप पूरा करना

कुछ एक्सटेंशन के लिए, आपको उनका इस्तेमाल करने से पहले, ज़रूरी या वैकल्पिक चरण पूरे करने होते हैं. ये निर्देश, Firebase कंसोल के Extensions डैशबोर्ड में, आपके एक्सटेंशन के इंस्टॉलेशन के बाद की जानकारी वाले पेज पर मिलेंगे. डैशबोर्ड का खास लिंक, इंस्टॉलेशन के बाद टर्मिनल में दिखता है.

ये निर्देश, एक्सटेंशन की सोर्स डायरेक्ट्री में शामिल POSTINSTALL.md फ़ाइल में भी मिल सकते हैं .

Firebase संसाधन बनाना

अगर आपने एक्सटेंशन को ऐसे Firebase संसाधनों (Cloud Firestore कलेक्शन, Realtime Database पाथ, Cloud Storage बकेट) का इस्तेमाल करने के लिए कॉन्फ़िगर किया है जो पहले से मौजूद नहीं हैं, तो एक्सटेंशन का इस्तेमाल करने से पहले उन्हें बनाएं.

Eventarc इवेंट हैंडलर बनाना

कुछ एक्सटेंशन, Eventarc पर, एक्ज़ीक्यूशन के दौरान अहम इवेंट होने पर पब्लिश करते हैं. अगर कोई एक्सटेंशन इवेंट पब्लिश करता है और आपने इंस्टॉलेशन के दौरान इवेंट चालू किए हैं, तो ऐसे फ़ंक्शन लिखे जा सकते हैं जो आपकी पसंद के मुताबिक लॉजिक के साथ इन इवेंट पर प्रतिक्रिया देते हैं. यह काम का हो सकता है. उदाहरण के लिए, लंबे समय तक चलने वाले टास्क पूरे होने पर उपयोगकर्ताओं को सूचना देना या एक्सटेंशन फ़ंक्शन के आउटपुट को पोस्ट-प्रोसेस करना.

एक्सटेंशन के दस्तावेज़ में, पब्लिश किए जाने वाले इवेंट की सूची देखें. अगर कोई सूची मौजूद है, तो उसे देखें. उदाहरण के लिए, Stripe के साथ पेमेंट करने वाले एक्सटेंशन के लिए इवेंट टाइप देखें.

इसके बाद, Eventarc इवेंट हैंडलर लिखने के बारे में जानकारी के लिए, कस्टम इवेंट ट्रिगर देखें.

एक से ज़्यादा एक्सटेंशन इंस्टेंस इंस्टॉल करना

एक ही प्रोजेक्ट में, एक ही एक्सटेंशन को एक से ज़्यादा बार इंस्टॉल किया जा सकता है. इंस्टॉल किए गए हर इंस्टेंस का अपना पसंद के मुताबिक कॉन्फ़िगरेशन और अपने एक्सटेंशन संसाधन हो सकते हैं. इंस्टॉल किए गए हर इंस्टेंस की पहचान और उसे रेफ़र करने के लिए, उसके instance ID का इस्तेमाल करें. यह आपके प्रोजेक्ट में यूनीक होता है.

एक्सटेंशन के हर अतिरिक्त इंस्टेंस के आईडी की पुष्टि करने या उसमें बदलाव करने के लिए कहा जाएगा.

अगले चरण