अपने वेब ऐप्लिकेशन के साथ Firebase SDK टूल इंटिग्रेट करना

Firebase App Hosting, Firebase JavaScript SDK और Node.js के लिए Firebase Admin SDK की मदद से बनाए गए डाइनैमिक वेब ऐप्लिकेशन के लिए एक बेहतरीन विकल्प है. सभी सुविधाओं वाले वेब ऐप्लिकेशन में, Firebase के एसडीके, जैसे कि Authentication, Cloud Firestore, और App Check की अहम भूमिका होती है. इस गाइड में, Firebase एसडीके को ऑप्टिमाइज़ करने और Firebase App Hosting पर अपने वेब ऐप्लिकेशन में Firebase को इंटिग्रेट करने के लिए, कुछ मुख्य रणनीतियां बताई गई हैं.

Firebase Admin SDK और वेब एसडीके अपने-आप शुरू होने की सुविधा

Firebase App Hosting जैसे Google एनवायरमेंट, बिल्ड टाइम और रनटाइम के दौरान बिना आर्ग्युमेंट वाले कंस्ट्रक्टर कॉल के ज़रिए, ऐप्लिकेशन को शुरू करने की प्रोसेस को आसान बनाते हैं. यह Firebase Admin SDK Node.js के लिए और Firebase JavaScript SDK, दोनों की सुविधा है. Node.js के लिए, सर्वर-साइड SDK है. यह Firebase की कई सुविधाओं को अनलॉक करता है और आपके वेब ऐप्लिकेशन में काफ़ी काम आ सकता है.

initializeApp() की मदद से, Firebase App Hosting को वेब ऐप्लिकेशन कॉन्फ़िगरेशन अपने-आप भरने की अनुमति दी जा सकती है. हालांकि, आपके पास अब भी कुछ खास वैल्यू पर बारीकी से कंट्रोल करने का विकल्प होता है. ऐसा तब होता है, जब आपको डिफ़ॉल्ट वैल्यू को बदलना हो.

बिना किसी आर्ग्युमेंट के शुरू करें

Firebase Admin SDK या Firebase JavaScript एसडीके को डिफ़ॉल्ट कॉन्फ़िगरेशन वैल्यू के साथ शुरू करने के लिए, बिना कोई आर्ग्युमेंट दिए initializeApp() का इस्तेमाल करें.

Admin SDK

import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();

Admin SDK के लिए, शुरू करने की यह रणनीति App Hosting के साथ-साथ Google के अन्य सर्वर एनवायरमेंट में भी काम करती है. इनमें Cloud Run, App Engine, और Cloud Run फ़ंक्शन शामिल हैं.

JavaScript SDK

import { initializeApp } from 'firebase/app';
const app = initializeApp();

JavaScript SDK के लिए, शुरू करने की यह रणनीति App Hosting में काम करती है.

अपने-आप भरी गई वैल्यू को बदलना

अपने-आप इंजेक्ट होने वाले डिफ़ॉल्ट कॉन्फ़िगरेशन को बदला जा सकता है. ध्यान दें कि Admin SDK और JavaScript SDK के बीच ये विकल्प अलग-अलग होते हैं.

Admin SDK ओवरराइड

Realtime Database, Cloud Storage या Cloud Functions जैसी सेवाओं के लिए, अपनी पसंद के मुताबिक शुरू करने के विकल्प तय किए जा सकते हैं. इसके लिए, FIREBASE_CONFIG एनवायरमेंट वैरिएबल का इस्तेमाल करें. अगर FIREBASE_CONFIG वैरिएबल का कॉन्टेंट { वर्ण से शुरू होता है, तो उसे JSON ऑब्जेक्ट के तौर पर पार्स किया जाएगा. ऐसा न होने पर, SDK टूल यह मान लेता है कि स्ट्रिंग, विकल्पों वाली JSON फ़ाइल का पाथ है.

# apphosting.yaml

env:
  - variable: FIREBASE_CONFIG
    value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'

JavaScript SDK टूल को बदलना

JavaScript SDK टूल को शुरू करने के लिए, App Hosting की ओर से इंजेक्ट की गई डिफ़ॉल्ट FIREBASE_WEBAPP_CONFIG वैल्यू को बदलने के लिए, apphosting.yaml में वैल्यू तय की जा सकती हैं:

# apphosting.yaml

env:
  - variable: FIREBASE_WEBAPP_CONFIG
    value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'

अन्य एनवायरमेंट में अपने-आप शुरू होने की सुविधा का इस्तेमाल करना

Firebase JavaScript SDK टूल इंस्टॉल करने पर, npm postinstall स्क्रिप्ट की मदद से, अपने-आप शुरू होने की सुविधा सेट अप हो जाती है. postinstall स्क्रिप्ट, एनवायरमेंट वैरिएबल FIREBASE_WEBAPP_CONFIG को खोजती है. यह वैरिएबल, App Hosting Cloud Build एनवायरमेंट में अपने-आप सेट हो जाता है.

अगर JS SDK को Cloud Build के बाहर इंस्टॉल किया जा रहा है, तो Firebase JavaScript SDK इंस्टॉल करते समय आपको यह एनवायरमेंट वैरिएबल खुद सेट करना होगा.

इंस्टॉलेशन के दौरान एनवायरमेंट को मैन्युअल तरीके से सेट अप करने के लिए:

  1. Firebase कंसोल से, Firebase वेब ऐप्लिकेशन का कॉन्फ़िगरेशन ऑब्जेक्ट कॉपी करें.

  2. npm install कमांड को चलाने से पहले, टर्मिनल से FIREBASE_WEBAPP_CONFIG एनवायरमेंट वैरिएबल सेट करें.

FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase

जब भी Firebase प्रोजेक्ट या वेब ऐप्लिकेशन में बदलाव किया जाए, तब इस कमांड को फिर से चलाएं. इंटरमीडिएट कैश (जैसे कि .next/cache) को भी मिटाना पड़ सकता है.

FirebaseServerApp का इस्तेमाल करके एसएसआर करना

अगर आपने अपना वेब ऐप्लिकेशन डेवलप करने के लिए, Firebase JS SDK या Firebase के अन्य क्लाइंट SDK टूल का इस्तेमाल किया है, तो आपको FirebaseApp इंटरफ़ेस और ऐप्लिकेशन के इंस्टेंस कॉन्फ़िगर करने के लिए इसका इस्तेमाल करने का तरीका पता होगा. सर्वर साइड पर इसी तरह के ऑपरेशन को आसान बनाने के लिए, Firebase FirebaseServerApp उपलब्ध कराता है.

FirebaseServerApp, FirebaseApp का एक वैरिएंट है. इसका इस्तेमाल सर्वर साइड रेंडरिंग (एसएसआर) एनवायरमेंट में किया जाता है. इसमें Firebase सेशन जारी रखने के लिए टूल शामिल हैं. ये टूल, क्लाइंट साइड रेंडरिंग (सीएसआर) / सर्वर साइड रेंडरिंग के बीच के अंतर को कम करते हैं.

FirebaseServerApp का इस्तेमाल करके:

  • उपयोगकर्ता के कॉन्टेक्स्ट में सर्वर-साइड कोड को लागू करना. इसके उलट, Firebase Admin SDK के पास एडमिन के सभी अधिकार होते हैं.
  • एसएसआर एनवायरमेंट में App Check का इस्तेमाल करने की अनुमति दें.
  • क्लाइंट में बनाए गए Firebase Auth सेशन को जारी रखें.

इन कामों के लिए FirebaseServerApp का इस्तेमाल करने के बारे में पूरी जानकारी पाने के लिए, एसएसआर की मदद से डाइनैमिक वेब ऐप्लिकेशन में Firebase का इस्तेमाल करना लेख पढ़ें.

अपने वेब ऐप्लिकेशन में App Check को चालू करना

App Check का इस्तेमाल करके, App Hosting पर अपने डाइनैमिक वेब ऐप्लिकेशन की सुरक्षा को बेहतर बनाया जा सकता है. एसएसआर की मदद से डाइनैमिक वेब ऐप्लिकेशन में Firebase का इस्तेमाल करना लेख में, सर्वर साइड की कुछ खास रणनीतियों के बारे में बताया गया है. इन्हें लागू करके, अपने App Hosting बैकएंड को गलत इस्तेमाल से बचाया जा सकता है.