वेब के लिए Firebase के बारे में जानकारी

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

अगर आपको किसी ऐसे विषय के बारे में सवाल पूछना है जिसके बारे में इस पेज पर नहीं बताया गया है, तो हमारी किसी ऑनलाइन समुदाय पर जाएं. हम समय-समय पर इस पेज को नए विषयों के साथ अपडेट भी करेंगे. इसलिए, यह देखने के लिए वापस आएं कि हमने वह विषय जोड़ा है या नहीं जिसके बारे में आपको जानना है.

SDK टूल के वर्शन: नेमस्पेस और मॉड्यूलर

Firebase, वेब ऐप्लिकेशन के लिए दो एपीआई प्लैटफ़ॉर्म उपलब्ध कराता है:

  • JavaScript - नेमस्पेस वाला. यह JavaScript इंटरफ़ेस है, जिसे Firebase ने कई सालों तक मैनेज किया है. साथ ही, पुराने Firebase ऐप्लिकेशन वाले वेब डेवलपर इससे अच्छी तरह वाकिफ़ हैं. namespaced API में नई सुविधाओं का ऐक्सेस नहीं मिलता. इसलिए, ज़्यादातर नए ऐप्लिकेशन में modular API का इस्तेमाल किया जाना चाहिए.
  • JavaScript - modular. यह एसडीके, मॉड्यूलर तरीके पर आधारित है. इससे एसडीके का साइज़ कम होता है और webpack या Rollup जैसे मॉडर्न JavaScript बिल्ड टूल की मदद से, बेहतर तरीके से काम किया जा सकता है.

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

हालांकि, modular API का ज़्यादातर हिस्सा, namespaced API के पैटर्न का ही पालन करता है, लेकिन कोड का संगठन अलग होता है. आम तौर पर, namespaced API को नेमस्पेस और सेवा पैटर्न के हिसाब से डिज़ाइन किया जाता है. वहीं, modular API को अलग-अलग फ़ंक्शन के हिसाब से डिज़ाइन किया जाता है. उदाहरण के लिए, namespaced API की डॉट-चेनिंग, जैसे कि firebaseApp.auth() को modular API में एक getAuth() फ़ंक्शन से बदल दिया जाता है. यह फ़ंक्शन, firebaseApp लेता है और Authentication इंस्टेंस दिखाता है.

इसका मतलब है कि namespaced API की मदद से बनाए गए वेब ऐप्लिकेशन को मॉड्यूलर ऐप्लिकेशन डिज़ाइन का फ़ायदा लेने के लिए, रीफ़ैक्टर करना ज़रूरी है. ज़्यादा जानकारी के लिए, अपग्रेड करने से जुड़ी गाइड देखें.

JavaScript - नए ऐप्लिकेशन के लिए modular API

अगर आपको Firebase के साथ नया इंटिग्रेशन शुरू करना है, तो SDK टूल को जोड़ने और उसे शुरू करने के दौरान, मॉड्यूलर एपीआई का इस्तेमाल करने का विकल्प चुना जा सकता है.

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

import { getAuth, onAuthStateChanged } from "firebase/auth";

const auth = getAuth(firebaseApp);
onAuthStateChanged(auth, user => {
  // Check for user status
});

ज़्यादा उदाहरण और जानकारी के लिए, हर प्रॉडक्ट एरिया की गाइड के साथ-साथ मॉड्यूलर एपीआई के रेफ़रंस दस्तावेज़ देखें.

अपने ऐप्लिकेशन में वेब एसडीके जोड़ने के तरीके

Firebase, ज़्यादातर Firebase प्रॉडक्ट के लिए JavaScript लाइब्रेरी उपलब्ध कराता है. इनमें Remote Config, FCM, और अन्य प्रॉडक्ट शामिल हैं. अपने वेब ऐप्लिकेशन में Firebase SDK टूल जोड़ने का तरीका इस बात पर निर्भर करता है कि ऐप्लिकेशन के साथ किस टूल का इस्तेमाल किया जा रहा है. जैसे, मॉड्यूल बंडलर.

इनमें से किसी एक तरीके का इस्तेमाल करके, अपने ऐप्लिकेशन में उपलब्ध लाइब्रेरी में से कोई भी लाइब्रेरी जोड़ी जा सकती है:

  • npm (मॉड्यूल बंडलर के लिए)
  • सीडीएन (कॉन्टेंट डिलीवरी नेटवर्क)

सेटअप करने के बारे में ज़्यादा जानकारी के लिए, अपने JavaScript ऐप्लिकेशन में Firebase जोड़ना लेख पढ़ें. इस सेक्शन के बाकी हिस्से में, उपलब्ध विकल्पों में से चुनने में आपकी मदद करने के लिए जानकारी दी गई है.

npm

Firebase npm पैकेज (जिसमें ब्राउज़र और Node.js बंडल, दोनों शामिल हैं) डाउनलोड करने पर, आपको Firebase SDK टूल की एक लोकल कॉपी मिलती है. इसकी ज़रूरत Node.js ऐप्लिकेशन, React Native या Electron जैसे नॉन-ब्राउज़र ऐप्लिकेशन के लिए पड़ सकती है. डाउनलोड किए गए डेटा में, कुछ पैकेज के लिए Node.js और React Native बंडल का विकल्प शामिल होता है. एसएसआर फ़्रेमवर्क के सर्वर-साइड रेंडरिंग (एसएसआर) चरण के लिए, Node.js बंडल ज़रूरी हैं.

webpack या Rollup जैसे मॉड्यूल बंडलर के साथ npm का इस्तेमाल करने पर, ऑप्टिमाइज़ेशन के विकल्प मिलते हैं. इनकी मदद से, इस्तेमाल न किए गए कोड को "ट्री-शेक" किया जा सकता है और टारगेट किए गए पॉलीफ़िल लागू किए जा सकते हैं. इससे आपके ऐप्लिकेशन का साइज़ काफ़ी कम हो सकता है. इन सुविधाओं को लागू करने से, आपके कॉन्फ़िगरेशन और बिल्ड चेन में कुछ जटिलताएं आ सकती हैं. हालांकि, मुख्यधारा के अलग-अलग सीएलआई टूल की मदद से, इस समस्या को कम किया जा सकता है. इन टूल में Angular, React, Vue, Next वगैरह शामिल हैं.

सारांश में:

  • ऐप्लिकेशन के साइज़ को ऑप्टिमाइज़ करने की सुविधा मिलती है
  • मॉड्यूल मैनेज करने के लिए, बेहतरीन टूल उपलब्ध हैं
  • Node.js के साथ एसएसआर के लिए ज़रूरी है

सीडीएन (कॉन्टेंट डिलीवरी नेटवर्क)

Firebase के सीडीएन पर सेव की गई लाइब्रेरी जोड़ना, एसडीके सेटअप करने का एक आसान तरीका है. इसके बारे में कई डेवलपर जानते हैं. SDK टूल जोड़ने के लिए सीडीएन का इस्तेमाल करने पर, आपको बिल्ड टूल की ज़रूरत नहीं पड़ेगी. साथ ही, मॉड्यूल बंडलर की तुलना में, आपकी बिल्ड चेन को इस्तेमाल करना ज़्यादा आसान हो सकता है. अगर आपको अपने ऐप्लिकेशन के इंस्टॉल किए गए साइज़ की ज़्यादा चिंता नहीं है और आपकी कोई खास ज़रूरत नहीं है, जैसे कि TypeScript से ट्रांसपाइल करना, तो सीडीएन एक अच्छा विकल्प हो सकता है.

सारांश में:

  • जाने-पहचाने और आसान
  • यह तब सही होता है, जब ऐप्लिकेशन का साइज़ कोई बड़ी समस्या न हो
  • यह तब सही होता है, जब आपकी वेबसाइट बिल्ड टूल का इस्तेमाल नहीं करती.

Firebase वेब SDK टूल के वैरिएंट

Firebase के वेब SDK टूल का इस्तेमाल, ब्राउज़र और Node ऐप्लिकेशन, दोनों में किया जा सकता है. हालांकि, कई प्रॉडक्ट Node एनवायरमेंट में उपलब्ध नहीं हैं. इस्तेमाल किए जा सकने वाले एनवायरमेंट की सूची देखें.

कुछ प्रॉडक्ट एसडीके, अलग-अलग ब्राउज़र और नोड वैरिएंट उपलब्ध कराते हैं. इनमें से हर वैरिएंट, ईएसएम और सीजेएस, दोनों फ़ॉर्मैट में उपलब्ध होता है. कुछ प्रॉडक्ट एसडीके, Cordova या React Native वैरिएंट भी उपलब्ध कराते हैं. वेब एसडीके को आपके टूल कॉन्फ़िगरेशन या एनवायरमेंट के आधार पर सही वैरिएंट उपलब्ध कराने के लिए कॉन्फ़िगर किया गया है. ज़्यादातर मामलों में, मैन्युअल तरीके से चुनने की ज़रूरत नहीं होती. SDK टूल के सभी वैरिएंट, असली उपयोगकर्ता के ऐक्सेस के लिए वेब ऐप्लिकेशन या क्लाइंट ऐप्लिकेशन बनाने में मदद करते हैं. जैसे, Node.js डेस्कटॉप या IoT ऐप्लिकेशन. अगर आपका लक्ष्य सर्वर जैसे खास ऐक्सेस वाले एनवायरमेंट से एडमिन के तौर पर ऐक्सेस सेट अप करना है, तो Firebase Admin SDK का इस्तेमाल करें.

बंडलर और फ़्रेमवर्क की मदद से एनवायरमेंट का पता लगाना

npm का इस्तेमाल करके Firebase वेब SDK टूल इंस्टॉल करने पर, JavaScript और Node.js, दोनों वर्शन इंस्टॉल हो जाते हैं. यह पैकेज, आपके ऐप्लिकेशन के लिए सही बंडल चालू करने के लिए, एनवायरमेंट की पूरी जानकारी देता है.

अगर आपका कोड Node.js require स्टेटमेंट का इस्तेमाल करता है, तो एसडीके, Node के हिसाब से बंडल ढूंढता है. इसके अलावा, आपके बंडलर की सेटिंग को सही तरीके से कॉन्फ़िगर किया जाना चाहिए, ताकि आपकी package.json फ़ाइल में सही एंट्री पॉइंट फ़ील्ड का पता लगाया जा सके. उदाहरण के लिए, main, browser या module. अगर आपको SDK टूल के साथ रनटाइम से जुड़ी गड़बड़ियां मिलती हैं, तो पक्का करें कि आपके बंडलर को आपके एनवायरमेंट के लिए सही तरह के बंडल को प्राथमिकता देने के लिए कॉन्फ़िगर किया गया हो.

Firebase कॉन्फ़िगरेशन ऑब्जेक्ट के बारे में जानकारी

अपने ऐप्लिकेशन में Firebase को शुरू करने के लिए, आपको अपने ऐप्लिकेशन का Firebase कॉन्फ़िगरेशन उपलब्ध कराना होगा. आपके पास किसी भी समय अपना Firebase कॉन्फ़िगरेशन ऑब्जेक्ट पाने का विकल्प होता है.

  • हमारा सुझाव है कि आप अपने कॉन्फ़िगरेशन ऑब्जेक्ट में मैन्युअल तरीके से बदलाव न करें. खास तौर पर, "Firebase के विकल्प" में बदलाव न करें: apiKey, projectId, और appID. अगर आपने इन ज़रूरी "Firebase विकल्पों" के लिए, अमान्य या अधूरी वैल्यू के साथ अपना ऐप्लिकेशन शुरू किया, तो आपके ऐप्लिकेशन के उपयोगकर्ताओं को गंभीर समस्याओं का सामना करना पड़ सकता है. हालांकि, authDomain को signInWithRedirect का इस्तेमाल करने के सबसे सही तरीके अपनाकर अपडेट किया जा सकता है.

  • अगर आपने अपने Firebase प्रोजेक्ट में Google Analytics को चालू किया है, तो आपके कॉन्फ़िगरेशन ऑब्जेक्ट में measurementId फ़ील्ड शामिल होगा. इस फ़ील्ड के बारे में ज़्यादा जानने के लिए, Analytics इस्तेमाल शुरू करने वाले पेज पर जाएं.

  • अगर आपने Firebase वेब ऐप्लिकेशन बनाने के बाद Google Analytics या Realtime Database को चालू किया है, तो पक्का करें कि आपके ऐप्लिकेशन में इस्तेमाल किए जाने वाले Firebase कॉन्फ़िगरेशन ऑब्जेक्ट को, उससे जुड़ी कॉन्फ़िगरेशन वैल्यू (क्रमशः measurementId और databaseURL) के साथ अपडेट किया गया हो. Firebase कॉन्फ़िगरेशन ऑब्जेक्ट को किसी भी समय हासिल किया जा सकता है.

यहां सभी सेवाएं चालू होने पर, कॉन्फ़िगरेशन ऑब्जेक्ट का फ़ॉर्मैट दिया गया है. ये वैल्यू अपने-आप भर जाती हैं:

var firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  // The value of `databaseURL` depends on the location of the database
  databaseURL: "https://DATABASE_NAME.firebaseio.com",
  projectId: "PROJECT_ID",
  // The value of `storageBucket` depends on when you provisioned your default bucket (learn more)
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
  measurementId: "G-MEASUREMENT_ID",
};

उपलब्ध लाइब्रेरी

सेटअप के अन्य विकल्प

सीडीएन से Firebase SDK टूल लोड होने में देरी होना

पूरा पेज लोड होने तक, Firebase SDK टूल को शामिल करने में देरी की जा सकती है. अगर <script type="module"> के साथ मॉड्यूलर एपीआई सीडीएन स्क्रिप्ट का इस्तेमाल किया जा रहा है, तो यह डिफ़ॉल्ट ऐक्शन और सेटिंग है. अगर नेमस्पेस वाली सीडीएन स्क्रिप्ट का इस्तेमाल मॉड्यूल के तौर पर किया जा रहा है, तो लोड होने में लगने वाले समय को कम करने के लिए यह तरीका अपनाएं:

  1. Firebase SDK टूल के लिए, हर script टैग में defer फ़्लैग जोड़ें. इसके बाद, दूसरी स्क्रिप्ट का इस्तेमाल करके, Firebase को शुरू करने की प्रोसेस को रोकें. उदाहरण के लिए:

    <script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-app.js"></script>
    
    <script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-auth.js"></script>
    <script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-firestore.js"></script>
    
    // ...
    
    <script defer src="./init-firebase.js"></script>
    
  2. एक init-firebase.js फ़ाइल बनाएं. इसके बाद, फ़ाइल में यह जानकारी शामिल करें:

    // TODO: Replace the following with your app's Firebase configuration
    var firebaseConfig = {
      // ...
    };
    
    // Initialize Firebase
    firebase.initializeApp(firebaseConfig);

एक ही ऐप्लिकेशन में कई Firebase प्रोजेक्ट इस्तेमाल करना

ज़्यादातर मामलों में, आपको सिर्फ़ एक डिफ़ॉल्ट ऐप्लिकेशन में Firebase को शुरू करना होता है. उस ऐप्लिकेशन से Firebase को दो तरीकों से ऐक्सेस किया जा सकता है:

Web

import { initializeApp } from "firebase/app";
import { getStorage } from "firebase/storage";
import { getFirestore } from "firebase/firestore";

// Initialize Firebase with a "default" Firebase project
const defaultProject = initializeApp(firebaseConfig);

console.log(defaultProject.name);  // "[DEFAULT]"

// Option 1: Access Firebase services via the defaultProject variable
let defaultStorage = getStorage(defaultProject);
let defaultFirestore = getFirestore(defaultProject);

// Option 2: Access Firebase services using shorthand notation
defaultStorage = getStorage();
defaultFirestore = getFirestore();

Web

// Initialize Firebase with a "default" Firebase project
const defaultProject = firebase.initializeApp(firebaseConfig);

console.log(defaultProject.name);  // "[DEFAULT]"

// Option 1: Access Firebase services via the defaultProject variable
let defaultStorage = defaultProject.storage();
let defaultFirestore = defaultProject.firestore();

// Option 2: Access Firebase services using shorthand notation
defaultStorage = firebase.storage();
defaultFirestore = firebase.firestore();

हालांकि, कभी-कभी आपको एक ही समय पर कई Firebase प्रोजेक्ट ऐक्सेस करने की ज़रूरत पड़ सकती है. उदाहरण के लिए, हो सकता है कि आपको किसी Firebase प्रोजेक्ट के डेटाबेस से डेटा पढ़ना हो, लेकिन फ़ाइलों को किसी दूसरे Firebase प्रोजेक्ट में सेव करना हो. इसके अलावा, ऐसा भी हो सकता है कि आपको एक प्रोजेक्ट की पुष्टि करनी हो और दूसरे प्रोजेक्ट की पुष्टि न करनी हो.

Firebase JavaScript SDK टूल की मदद से, एक ही ऐप्लिकेशन में एक साथ कई Firebase प्रोजेक्ट शुरू किए जा सकते हैं और उनका इस्तेमाल किया जा सकता है. हर प्रोजेक्ट, Firebase कॉन्फ़िगरेशन की अपनी जानकारी का इस्तेमाल करता है.

Web

import { initializeApp, getApp } from "firebase/app";
import { getStorage } from "firebase/storage";
import { getFirestore } from "firebase/firestore";

// Initialize Firebase with a default Firebase project
initializeApp(firebaseConfig);

// Initialize Firebase with a second Firebase project
const otherProject = initializeApp(otherProjectFirebaseConfig, "other");

console.log(getApp().name);  // "[DEFAULT]"
console.log(otherProject.name);    // "otherProject"

// Use the shorthand notation to access the default project's Firebase services
const defaultStorage = getStorage();
const defaultFirestore = getFirestore();

// Use the otherProject variable to access the second project's Firebase services
const otherStorage = getStorage(otherProject);
const otherFirestore = getFirestore(otherProject);

Web

// Initialize Firebase with a default Firebase project
firebase.initializeApp(firebaseConfig);

// Initialize Firebase with a second Firebase project
const otherProject = firebase.initializeApp(otherProjectFirebaseConfig, "other");

console.log(firebase.app().name);  // "[DEFAULT]"
console.log(otherProject.name);    // "otherProject"

// Use the shorthand notation to access the default project's Firebase services
const defaultStorage = firebase.storage();
const defaultFirestore = firebase.firestore();

// Use the otherProject variable to access the second project's Firebase services
const otherStorage = otherProject.storage();
const otherFirestore = otherProject.firestore();

डेवलपमेंट के लिए लोकल वेब सर्वर चलाना

अगर कोई वेब ऐप्लिकेशन बनाया जा रहा है, तो Firebase JavaScript SDK टूल के कुछ हिस्सों के लिए ज़रूरी है कि आप अपने वेब ऐप्लिकेशन को लोकल फ़ाइल सिस्टम के बजाय सर्वर से चलाएं. लोकल सर्वर चलाने के लिए, Firebase सीएलआई का इस्तेमाल किया जा सकता है.

अगर आपने अपने ऐप्लिकेशन के लिए Firebase Hosting को पहले ही सेट अप कर लिया है, तो हो सकता है कि आपने नीचे दिए गए कई चरणों को पहले ही पूरा कर लिया हो.

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

  1. Firebase सीएलआई के दस्तावेज़ पर जाकर, सीएलआई इंस्टॉल करने या इसके नए वर्शन पर अपडेट करने का तरीका जानें.

  2. अपना Firebase प्रोजेक्ट शुरू करें. अपनी लोकल ऐप्लिकेशन डायरेक्ट्री के रूट से यह कमांड चलाएं:

    firebase init

  3. डेवलपमेंट के लिए लोकल सर्वर चालू करें. अपने लोकल ऐप्लिकेशन की डायरेक्ट्री के रूट से, यह कमांड चलाएं:

    firebase serve

Firebase JavaScript SDK टूल के लिए ओपन सोर्स संसाधन

Firebase, ओपन सोर्स डेवलपमेंट के साथ काम करता है. साथ ही, हम कम्यूनिटी के योगदान और सुझावों को बढ़ावा देते हैं.

Firebase JavaScript SDKs

ज़्यादातर Firebase JavaScript SDK टूल, हमारी सार्वजनिक Firebase GitHub रिपॉज़िटरी में ओपन सोर्स लाइब्रेरी के तौर पर डेवलप किए जाते हैं.

क्विकस्टार्ट सैंपल

Firebase, वेब पर ज़्यादातर Firebase एपीआई के लिए, क्विकस्टार्ट सैंपल का कलेक्शन रखता है. ये क्विकस्टार्ट, हमारी सार्वजनिक Firebase GitHub क्विकस्टार्ट रिपॉज़िटरी में मिल सकते हैं. Firebase SDK टूल इस्तेमाल करने के लिए, इन क्विकस्टार्ट को उदाहरण के तौर पर इस्तेमाल किया जा सकता है.