अपना ऐप्लिकेशन कनेक्ट करें और प्रोटोटाइप बनाना शुरू करें


Firebase Local Emulator Suite का इस्तेमाल शुरू करने से पहले, पक्का करें कि आपने Firebase प्रोजेक्ट बना लिया है, अपना डेवलपमेंट एनवायरमेंट सेट अप किया है, और अपने प्लैटफ़ॉर्म के Firebase का इस्तेमाल शुरू करें विषयों के मुताबिक अपने प्लैटफ़ॉर्म के लिए Firebase SDK टूल चुने और इंस्टॉल किए हैं: Apple, Android या वेब.

प्रोटोटाइप बनाना और उसकी जांच करना

Local Emulator Suite में कई प्रॉडक्ट एमुलेटर होते हैं, जैसा कि Firebase Local Emulator Suite के बारे में जानकारी में बताया गया है. प्रोटोटाइप बनाने और जांच करने के लिए, अलग-अलग एमुलेटर के साथ-साथ एमुलेटर के कॉम्बिनेशन का इस्तेमाल किया जा सकता है. यह इस बात पर निर्भर करता है कि प्रोडक्शन में किन Firebase प्रॉडक्ट का इस्तेमाल किया जा रहा है.

Firebase डेटाबेस और फ़ंक्शन एमुलेटर के बीच इंटरैक्शन
डेटाबेस और Cloud Functions एम्युलेटर पूरा Local Emulator Suite के हिस्से के तौर पर.

इस विषय के लिए, Local Emulator Suite वर्कफ़्लो के बारे में बताने के लिए, मान लें कि आप ऐसे ऐप्लिकेशन पर काम कर रहे हैं जो प्रॉडक्ट के सामान्य कॉम्बिनेशन का इस्तेमाल करता है: Firebase डेटाबेस और उस डेटाबेस पर किए गए ऑपरेशन से ट्रिगर होने वाले क्लाउड फ़ंक्शन.

Firebase प्रोजेक्ट को लोकल तौर पर शुरू करने के बाद, Local Emulator Suite का इस्तेमाल करके डेवलपमेंट साइकल में आम तौर पर ये तीन चरण होते हैं:

  1. प्रोटोटाइप की सुविधाएं, एमुलेटर और Emulator Suite UI के साथ इंटरैक्टिव तरीके से काम करती हैं.

  2. अगर डेटाबेस एमुलेटर या Cloud Functions एमुलेटर का इस्तेमाल किया जा रहा है, तो अपने ऐप्लिकेशन को एमुलेटर से कनेक्ट करने के लिए, एक बार यह तरीका अपनाएं.

  3. एम्युलेटर और कस्टम स्क्रिप्ट का इस्तेमाल करके, अपने टेस्ट ऑटोमेट करें.

स्थानीय तौर पर Firebase प्रोजेक्ट शुरू करना

पक्का करें कि आपने सीएलआई इंस्टॉल किया हो या उसके सबसे नए वर्शन पर अपडेट किया हो.

curl -sL firebase.tools | bash

अगर आपने अभी तक ऐसा नहीं किया है, तो मौजूदा डायरेक्ट्री को Firebase प्रोजेक्ट के तौर पर शुरू करें. स्क्रीन पर दिए गए निर्देशों का पालन करके बताएं कि आपने Cloud Functions के साथ-साथ Cloud Firestore या Realtime Database का इस्तेमाल किया है या नहीं:

firebase init

आपकी प्रोजेक्ट डायरेक्ट्री में अब Firebase कॉन्फ़िगरेशन फ़ाइलें, Firebase Security Rules डेटाबेस के लिए डेफ़िनिशन फ़ाइल, functions डायरेक्ट्री, और Cloud Functions कोड के साथ-साथ अन्य फ़ाइलें शामिल होंगी.

इंटरैक्टिव तरीके से प्रोटोटाइप बनाना

Local Emulator Suite को नई सुविधाओं के प्रोटोटाइप को तेज़ी से बनाने के लिए डिज़ाइन किया गया है. साथ ही, Suite का पहले से मौजूद यूज़र इंटरफ़ेस, प्रोटोटाइप बनाने के सबसे काम के टूल में से एक है. यह कुछ हद तक स्थानीय तौर पर Firebase कंसोल चलाने जैसा है.

Emulator Suite UI का इस्तेमाल करके, डेटाबेस के डिज़ाइन को दोहराया जा सकता है. साथ ही, क्लाउड फ़ंक्शन वाले अलग-अलग डेटाफ़्लो आज़माए जा सकते हैं, सुरक्षा नियमों में हुए बदलावों का आकलन किया जा सकता है, और बैक-एंड सेवाओं की परफ़ॉर्मेंस की पुष्टि करने के लिए लॉग देखे जा सकते हैं. इसके बाद, अगर आपको फिर से शुरू करना है, तो बस अपना डेटाबेस मिटाएं और नए डिज़ाइन आइडिया के साथ फिर से शुरू करें.

Local Emulator Suite की शुरुआत करने पर, ये सभी सुविधाएं उपलब्ध होती हैं:

firebase emulators:start

अपने काल्पनिक ऐप्लिकेशन का प्रोटोटाइप बनाने के लिए, डेटाबेस में टेक्स्ट एंट्री में बदलाव करने के लिए, एक बुनियादी क्लाउड फ़ंक्शन सेट अप और टेस्ट करें. साथ ही, Emulator Suite UI में उस डेटाबेस को बनाएं और उसमें डेटा भरें, ताकि उसे ट्रिगर किया जा सके.

  1. अपनी प्रोजेक्ट डायरेक्ट्री में मौजूद functions/index.js फ़ाइल में बदलाव करके, डेटाबेस में लिखने के बाद ट्रिगर होने वाला क्लाउड फ़ंक्शन बनाएं. मौजूदा फ़ाइल के कॉन्टेंट को, यहां दिए गए स्निपेट से बदलें. यह फ़ंक्शन messages कलेक्शन में मौजूद दस्तावेज़ों में हुए बदलावों का पता लगाता है. किसी दस्तावेज़ के original फ़ील्ड के कॉन्टेंट को अपरकेस में बदलता है और नतीजे को उस दस्तावेज़ के uppercase फ़ील्ड में सेव करता है.
  2.   const functions = require('firebase-functions/v1');
    
      exports.makeUppercase = functions.firestore.document('/messages/{documentId}')
          .onCreate((snap, context) => {
            const original = snap.data().original;
            console.log('Uppercasing', context.params.documentId, original);
            const uppercase = original.toUpperCase();
            return snap.ref.set({uppercase}, {merge: true});
          });
      
  3. firebase emulators:start का इस्तेमाल करके Local Emulator Suite लॉन्च करें. Cloud Functions और डेटाबेस एम्युलेटर शुरू होते हैं. ये इंटरऑपरेट करने के लिए अपने-आप कॉन्फ़िगर होते हैं.
  4. http://localhost:4000 पर जाकर, अपने ब्राउज़र में यूज़र इंटरफ़ेस (यूआई) देखें. यूज़र इंटरफ़ेस (यूआई) के लिए, पोर्ट 4000 डिफ़ॉल्ट तौर पर सेट होता है. हालांकि, Firebase सीएलआई की मदद से, टर्मिनल मैसेज का आउटपुट देखें. उपलब्ध एम्युलेटर की स्थिति को नोट करें. हमारे मामले में, Cloud Functions और Cloud Firestore एमुलेटर चल रहे होंगे.
    मेरी इमेज
  5. यूज़र इंटरफ़ेस (यूआई) में, Firestore > डेटा टैब पर, कलेक्शन शुरू करें पर क्लिक करें. इसके बाद, messages कलेक्शन में नया दस्तावेज़ बनाने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें. इसमें फ़ील्ड का नाम original और वैल्यू test शामिल करें. इससे हमारा क्लाउड फ़ंक्शन ट्रिगर होता है. देखें कि जल्द ही नया uppercase फ़ील्ड दिखता है और इसमें "TEST" स्ट्रिंग भर जाती है.
    मेरी इमेज मेरी इमेज
  6. Firestore > अनुरोध टैब में, अपने एमुलेट किए गए डेटाबेस के लिए किए गए अनुरोधों की जांच करें. इनमें, उन अनुरोधों को पूरा करने के लिए किए गए सभी Firebase Security Rules आकलन भी शामिल हैं.
  7. लॉग टैब देखें और पुष्टि करें कि आपके फ़ंक्शन में कोई गड़बड़ी नहीं हुई है, क्योंकि इससे डेटाबेस अपडेट हो गया.

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

अपने ऐप्लिकेशन को एम्युलेटर से कनेक्ट करें

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

याद रखें कि Local Emulator Suite एक लोकल डेवलपमेंट टूल है. आपके प्रोडक्शन डेटाबेस में लिखने पर, उन फ़ंक्शन को ट्रिगर नहीं किया जाएगा जिन्हें स्थानीय तौर पर प्रोटोटाइप किया जा रहा है.

अगर आपको अपने ऐप्लिकेशन को डेटाबेस में राइट करने का विकल्प चुनना है, तो आपको Cloud Firestore एम्युलेटर पर, टेस्ट क्लास या ऐप्लिकेशन के कॉन्फ़िगरेशन को पॉइंट करना होगा.

Kotlin+KTX
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val firestore = Firebase.firestore
firestore.useEmulator("10.0.2.2", 8080)

firestore.firestoreSettings = firestoreSettings {
    isPersistenceEnabled = false
}
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseFirestore firestore = FirebaseFirestore.getInstance();
firestore.useEmulator("10.0.2.2", 8080);

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
firestore.setFirestoreSettings(settings);
Swift
let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settings

Web

import { getFirestore, connectFirestoreEmulator } from "firebase/firestore";

// firebaseApps previously initialized using initializeApp()
const db = getFirestore();
connectFirestoreEmulator(db, '127.0.0.1', 8080);

Web

// Firebase previously initialized using firebase.initializeApp().
var db = firebase.firestore();
if (location.hostname === "localhost") {
  db.useEmulator("127.0.0.1", 8080);
}

कस्टम स्क्रिप्ट की मदद से, अपने टेस्ट अपने-आप चलने की सुविधा चालू करना

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

firebase emulators:exec "./testdir/test.sh"

अलग-अलग एम्युलेटर के बारे में ज़्यादा जानें

अब आपने क्लाइंट-साइड का बुनियादी वर्कफ़्लो देख लिया है, तो आपके पास इस सुइट में मौजूद एम्युलेटर के बारे में जारी रखने का विकल्प है. इसमें सर्वर साइड ऐप्लिकेशन बनाने के लिए, उनका इस्तेमाल करने के तरीके की जानकारी भी शामिल है:

आगे क्या करना है?

ऊपर दिए गए लिंक किए गए खास एमुलेटर से जुड़े विषय ज़रूर पढ़ें. इसके बाद: