Firebase कंसोल, Firebase CLI (कमांड-लाइन इंटरफ़ेस) या अपने-आप जनरेट हुए SDK टूल का इस्तेमाल करके, Firebase के किसी भी आधिकारिक एक्सटेंशन को इंस्टॉल (और मैनेज) किया जा सकता है.
हर इंस्टॉलेशन के तरीके के लिए, काम करने वाली कार्रवाइयों में अंतर देखना न भूलें.
एक्सटेंशन इंस्टॉल या मैनेज करने के लिए, आपको इनमें से कोई एक भूमिका असाइन करनी होगी: मालिक या एडिटर या Firebase एडमिन.
एक्सटेंशन इंस्टॉल करने के लिए, आपका प्रोजेक्ट Blaze (पेमेंट के साथ-साथ) प्लान पर होना चाहिए. एक्सटेंशन इंस्टॉल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, अगर Firebase की सेवाओं या Cloud Secret Manager जैसी Cloud की सेवाओं का इस्तेमाल, बिना शुल्क के इस्तेमाल की सीमा से ज़्यादा किया जाता है, तो आपसे शुल्क लिया जा सकता है.
शुरू करने से पहले
अगर आपने पहले से ही अपने प्रोजेक्ट में Firebase नहीं जोड़ा है, तो अपने Firebase प्रोजेक्ट को Blaze (पे-ऐज़-यू-गो) प्लान पर अपग्रेड करें.
पहला चरण: किसी एक्सटेंशन के बारे में पूरी जानकारी देखें
यह चरण ज़रूरी नहीं है, लेकिन इसका सुझाव दिया जाता है.
हमारा सुझाव है कि Firebase Extension इंस्टॉल करने से पहले, आप एक्सटेंशन के बारे में पूरी जानकारी देख लें. इसमें ये चीज़ें शामिल हैं:
- एक्सटेंशन कैसे काम करता है, पहले से इंस्टॉल करने के सभी टास्क, और एक्सटेंशन के बारे में जानकारी
- पहचान से जुड़ी सामान्य जानकारी और ब्यौरा
- एक्सटेंशन के टास्क के लिए बिलिंग खाते की ज़रूरत है या नहीं
- Google की सेवाएं (एपीआई) और ऑपरेशन के लिए ज़रूरी ऐक्सेस भूमिकाएं
- एक्सटेंशन के लिए बनाए गए संसाधन (जैसे, फ़ंक्शन)
- उपयोगकर्ता के कॉन्फ़िगर किए जा सकने वाले पैरामीटर के बारे में जानकारी
किसी एक्सटेंशन की ज़्यादा जानकारी देखने के लिए:
Extensions Hub में, Firebase के आधिकारिक एक्सटेंशन ब्राउज़ करें.
किसी एक्सटेंशन के कार्ड पर क्लिक करके:
एक्सटेंशन के बारे में ज़्यादा जानकारी दिखाएं.
Firebase Extensions सोर्स रिपॉज़िटरी में, एक्सटेंशन के सोर्स कोड का लिंक ढूंढें.
एक्सटेंशन की एक्सटेंशन डायरेक्ट्री में,
READMEमें यह पूरी जानकारी देखी जा सकती है.
दूसरा चरण: एक्सटेंशन इंस्टॉल करना
इंस्टॉलेशन की प्रोसेस के दौरान, आपसे एक्सटेंशन की बुनियादी जानकारी की समीक्षा करने के लिए कहा जाएगा. जैसे, चालू किए गए एपीआई, बनाए गए संसाधन, दिया गया ऐक्सेस वगैरह. आपको बिलिंग की सभी ज़रूरी शर्तों की सूचना दी जाएगी. साथ ही, एक्सटेंशन के कॉन्फ़िगर किए जा सकने वाले पैरामीटर के लिए वैल्यू तय करने को भी कहा जाएगा.
Extensions Hub में, Firebase के आधिकारिक एक्सटेंशन ब्राउज़ करें.
किसी एक्सटेंशन के कार्ड पर क्लिक करें. इसके बाद, एक्सटेंशन के बारे में पूरी जानकारी देखें. इसमें, इस्तेमाल से जुड़े खास निर्देश और इंस्टॉल करने से पहले किए जाने वाले टास्क शामिल हो सकते हैं.
इंस्टॉल करें पर क्लिक करें. इसके बाद, एक्सटेंशन को इंस्टॉल करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
तीसरा चरण: पोस्ट-इंस्टॉल सेटअप पूरा करें
कुछ एक्सटेंशन का इस्तेमाल करने से पहले, आपको कुछ ज़रूरी या वैकल्पिक चरण पूरे करने होंगे. ये निर्देश, Firebase कंसोल के Extensions डैशबोर्ड में, इंस्टॉल के बाद एक्सटेंशन की जानकारी वाले पेज पर देखे जा सकते हैं. डैशबोर्ड का लिंक, इंस्टॉल के बाद टर्मिनल में दिखता है.
ये निर्देश, एक्सटेंशन की सोर्स डायरेक्ट्री में मौजूद POSTINSTALL.md फ़ाइल में भी मिल सकते हैं.
Firebase संसाधन बनाना
अगर आपने एक्सटेंशन को ऐसे Firebase संसाधनों (Cloud Firestore कलेक्शन, Realtime Database पाथ, Cloud Storage बकेट) का इस्तेमाल करने के लिए कॉन्फ़िगर किया है जो पहले से मौजूद नहीं हैं, तो एक्सटेंशन का इस्तेमाल करने से पहले उन्हें बनाएं.
Eventarc इवेंट हैंडलर बनाना
एक्ज़ीक्यूशन के दौरान अहम इवेंट होने पर, कुछ एक्सटेंशन Eventarc में पब्लिश किए जाते हैं. अगर कोई एक्सटेंशन, इवेंट पब्लिश करता है और इंस्टॉल करने के दौरान इवेंट चालू किए जाते हैं, तो आपके पास ऐसे फ़ंक्शन लिखने का विकल्प होता है जो अपने कस्टम लॉजिक से इन इवेंट पर प्रतिक्रिया देते हों. उदाहरण के लिए, यह सुविधा लंबे समय तक चलने वाले टास्क पूरे होने पर उपयोगकर्ताओं को सूचना देने या एक्सटेंशन फ़ंक्शन के आउटपुट को पोस्ट-प्रोसेस करने के लिए काम की हो सकती है.
अगर एक्सटेंशन कोई इवेंट पब्लिश करता है, तो उसकी सूची देखने के लिए एक्सटेंशन का दस्तावेज़ देखें. उदाहरण के लिए, Stripe एक्सटेंशन की मदद से पेमेंट करने के लिए, इवेंट के टाइप देखें.
इसके बाद, Eventarc इवेंट हैंडलर लिखने के बारे में जानकारी पाने के लिए, कस्टम इवेंट ट्रिगर देखें.
एक से ज़्यादा एक्सटेंशन इंस्टॉल करना
एक ही प्रोजेक्ट में एक ही एक्सटेंशन को एक से ज़्यादा बार इंस्टॉल किया जा सकता है. इंस्टॉल किए गए हर इंस्टेंस में, पसंद के मुताबिक कॉन्फ़िगरेशन और अपने ज़रूरत के मुताबिक एक्सटेंशन रिसॉर्स हो सकते हैं. इंस्टॉल किए गए हर इंस्टेंस की पहचान करने और उससे जुड़ी जानकारी पाने के लिए, उसके इंस्टेंस आईडी का इस्तेमाल किया जाता है. यह आईडी, आपके प्रोजेक्ट में यूनीक होता है.
आपको इंस्टॉल किए गए एक्सटेंशन के हर अतिरिक्त इंस्टेंस के इंस्टेंस आईडी की पुष्टि करने या उसमें बदलाव करने के लिए कहा जाएगा.
अगले चरण
Firebase कंसोल में, इंस्टॉल किए गए एक्सटेंशन की जानकारी और कॉन्फ़िगरेशन देखें.
इंस्टॉल किए गए एक्सटेंशन की गतिविधि को मॉनिटर करें. इसमें, उसकी परफ़ॉर्मेंस, इस्तेमाल, और लॉग की जांच करना शामिल है.
Firebase कंसोल का इस्तेमाल करके, अपने इंस्टॉल किए गए एक्सटेंशन को मैनेज करें. आधिकारिक Firebase एक्सटेंशन के लिए, अपने एक्सटेंशन को फिर से कॉन्फ़िगर किया जा सकता है या अनइंस्टॉल किया जा सकता है. साथ ही, अपने एक्सटेंशन को नए वर्शन पर अपडेट किया जा सकता है.
सभी प्रोजेक्ट के लिए सबसे सही तरीका यह है कि अपने प्रोजेक्ट के लिए बजट से जुड़ी सूचनाएं सेट अप करें. साथ ही, Firebase कंसोल में इस्तेमाल और बिलिंग डैशबोर्ड को मॉनिटर करें.