Firebase कंसोल, Firebase सीएलआई (कमांड-लाइन इंटरफ़ेस) या अपने-आप जनरेट होने वाले एसडीके का इस्तेमाल करके, किसी भी आधिकारिक Firebase एक्सटेंशन को इंस्टॉल किया जा सकता है. साथ ही, उन्हें मैनेज किया जा सकता है.
यह ज़रूर देखें कि हर इंस्टॉलेशन के तरीके के लिए, कौन-कौनसी कार्रवाइयां की जा सकती हैं.
एक्सटेंशन इंस्टॉल करने या मैनेज करने के लिए, आपको इनमें से कोई एक भूमिका असाइन की जानी चाहिए: मालिक या एडिटर या Firebase एडमिन.
एक्सटेंशन इंस्टॉल करने के लिए, आपका प्रोजेक्ट Blaze (इस्तेमाल के हिसाब से शुल्क चुकाएं) प्लान पर होना चाहिए. एक्सटेंशन इंस्टॉल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, अगर Firebase या Cloud Secret Manager जैसी क्लाउड सेवाओं का इस्तेमाल, इनके मुफ़्त टियर में तय सीमा से ज़्यादा किया जाता है, तो आपसे शुल्क लिया जा सकता है.
शुरू करने से पहले
अगर आपने पहले से ही Firebase को अपने प्रोजेक्ट में नहीं जोड़ा है, तो 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 को सूचना देते हैं. अगर कोई एक्सटेंशन इवेंट पब्लिश करता है और आपने इंस्टॉलेशन के दौरान इवेंट चालू किए हैं, तो आपके पास ऐसे फ़ंक्शन लिखने का विकल्प होता है जो इन इवेंट पर प्रतिक्रिया देते हैं. इसके लिए, आपको अपने कस्टम लॉजिक का इस्तेमाल करना होगा. यह सुविधा तब काम आ सकती है, जब लंबे समय तक चलने वाले टास्क पूरे होने पर उपयोगकर्ताओं को सूचना देनी हो या एक्सटेंशन फ़ंक्शन के आउटपुट को प्रोसेस करना हो.
एक्सटेंशन के दस्तावेज़ में, पब्लिश किए गए इवेंट की सूची देखें. उदाहरण के लिए, Run Payments with Stripe एक्सटेंशन के लिए इवेंट टाइप देखें.
इसके बाद, Eventarc इवेंट हैंडलर लिखने के बारे में जानकारी पाने के लिए, कस्टम इवेंट ट्रिगर देखें.
एक्सटेंशन के एक से ज़्यादा इंस्टेंस इंस्टॉल करना
एक ही प्रोजेक्ट में, एक ही एक्सटेंशन को एक से ज़्यादा बार इंस्टॉल किया जा सकता है. इंस्टॉल किए गए हर इंस्टेंस का अपना पसंद के मुताबिक बनाया गया कॉन्फ़िगरेशन और एक्सटेंशन रिसॉर्स हो सकते हैं. हर इंस्टॉल किए गए इंस्टेंस की पहचान करने और उसे रेफ़र करने के लिए, उसके instance ID का इस्तेमाल करें. यह आईडी, आपके प्रोजेक्ट में यूनीक होता है.
आपको इंस्टॉल किए गए एक्सटेंशन के हर अतिरिक्त इंस्टेंस के इंस्टेंस आईडी की पुष्टि करने या उसमें बदलाव करने के लिए कहा जाएगा.
अगले चरण
Firebase कंसोल में जाकर, इंस्टॉल किए गए एक्सटेंशन की जानकारी और कॉन्फ़िगरेशन देखें.
आपने जो एक्सटेंशन इंस्टॉल किया है उसकी गतिविधि को मॉनिटर करें. इसमें एक्सटेंशन की परफ़ॉर्मेंस, इस्तेमाल, और लॉग की जांच करना शामिल है.
Firebase कंसोल का इस्तेमाल करके, इंस्टॉल किए गए एक्सटेंशन को मैनेज करें. आधिकारिक Firebase एक्सटेंशन के लिए, एक्सटेंशन को फिर से कॉन्फ़िगर किया जा सकता है या अनइंस्टॉल किया जा सकता है. साथ ही, एक्सटेंशन को नए वर्शन में अपडेट किया जा सकता है.
सभी प्रोजेक्ट के लिए, यह सबसे सही तरीका है कि आप अपने प्रोजेक्ट के लिए बजट से जुड़ी सूचनाएं सेट अप करें. साथ ही, Firebase कंसोल में इस्तेमाल और बिलिंग डैशबोर्ड पर नज़र रखें.