इंस्टॉलेशन & Apple प्लैटफ़ॉर्म पर सेटअप करें

Firebase Realtime Database, क्लाउड पर होस्ट किया गया डेटाबेस है. डेटा को JSON के तौर पर सेव किया जाता है. साथ ही, इसे कनेक्ट किए गए हर क्लाइंट के साथ रीयलटाइम में सिंक किया जाता है. Android, iOS, और JavaScript SDK टूल की मदद से, क्रॉस-प्लैटफ़ॉर्म ऐप्लिकेशन बनाने पर, आपके सभी क्लाइंट एक Realtime Database इंस्टेंस शेयर करते हैं. साथ ही, उन्हें नए डेटा के साथ अपडेट अपने-आप मिलते हैं.

Firebase Realtime Database Apple के सभी प्लैटफ़ॉर्म पर उपलब्ध है. जैसे, iOS, macOS, macOS Catalyst, tvOS, और watchOS. यह सुविधा, ऐप्लिकेशन क्लिप के लिए उपलब्ध नहीं है. इस पेज पर दिए गए सेटअप निर्देशों में, कुछ उदाहरणों में iOS का रेफ़रंस दिया गया है. हालांकि, ये निर्देश सामान्य हैं और Apple के किसी भी प्लैटफ़ॉर्म टारगेट के लिए काम करते हैं.

ज़रूरी शर्तें

1. Firebase SDK टूल इंस्टॉल करें.
2. Firebase कंसोल में, अपने ऐप्लिकेशन को Firebase प्रोजेक्ट से जोड़ें.

डेटाबेस बनाना

1. Firebase कंसोल के Realtime Database सेक्शन पर जाएं. आपको कोई मौजूदा Firebase प्रोजेक्ट चुनने के लिए कहा जाएगा. डेटाबेस बनाने का वर्कफ़्लो अपनाएं.

2. अपने Firebase Security Rules के लिए, कोई शुरुआती मोड चुनें:

   टेस्ट मोड

   मोबाइल और वेब क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करने के लिए यह सही है. हालांकि, इससे कोई भी व्यक्ति आपका डेटा पढ़ सकता है और उसे बदल सकता है. टेस्टिंग के बाद, Firebase Realtime Database के नियमों को समझना सेक्शन को ज़रूर पढ़ें.

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

   वेब, Apple या Android SDK टूल का इस्तेमाल शुरू करने के लिए, testmode चुनें.

   लॉक मोड

   यह कुकी, मोबाइल और वेब क्लाइंट से सभी तरह के पढ़ने और लिखने के अनुरोधों को अस्वीकार करती है. पुष्टि किए गए आपके ऐप्लिकेशन सर्वर, अब भी आपके डेटाबेस को ऐक्सेस कर सकते हैं.

3. डेटाबेस के लिए कोई जगह चुनें.

   डेटाबेस की जगह के आधार पर, नए डेटाबेस का यूआरएल इनमें से किसी एक फ़ॉर्म में होगा:

   • DATABASE_NAME.firebaseio.com (us-central1 में मौजूद डेटाबेस के लिए)

   • DATABASE_NAME.REGION.firebasedatabase.app (अन्य सभी जगहों पर मौजूद डेटाबेस के लिए)

4. हो गया पर क्लिक करें.

Realtime Database को चालू करने पर, Cloud API Manager में भी एपीआई चालू हो जाता है.

अपने ऐप्लिकेशन में Firebase Realtime Database जोड़ना

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.

Apple प्रोजेक्ट में Firebase SDK टूल जोड़ने के अलग-अलग तरीकों के बारे में जानने के लिए, इंस्टॉल करने से जुड़ी हमारी गाइड पढ़ें. इसमें फ़्रेमवर्क को सीधे तौर पर इंपोर्ट करने और CocoaPods का इस्तेमाल करने के बारे में बताया गया है.

1. Xcode में, अपने ऐप्लिकेशन प्रोजेक्ट को खोलें. इसके बाद, File > Add Packages पर जाएं.
2. जब आपसे कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk.git

ध्यान दें: नए प्रोजेक्ट में, डिफ़ॉल्ट (नवीनतम) एसडीके वर्शन का इस्तेमाल किया जाना चाहिए. हालांकि, ज़रूरत पड़ने पर पुराना वर्शन चुना जा सकता है.
3. Realtime Database लाइब्रेरी चुनें.
4. टारगेट की बिल्ड सेटिंग के Other Linker Flags सेक्शन में -ObjC फ़्लैग जोड़ें.
5. इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करना शुरू कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा.

Realtime Database Security Rules को कॉन्फ़िगर करना

Realtime Database, नियमों की ऐसी भाषा उपलब्ध कराता है जिससे यह तय किया जा सकता है कि आपके डेटा को कैसे स्ट्रक्चर किया जाए, उसे कैसे इंडेक्स किया जाए, और उसे कब पढ़ा और लिखा जा सकता है.

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

Firebase Realtime Database सेट अप करें

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

1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल के साथ-साथ, ऐप्लिकेशन डेलिगेट इस्तेमाल करने वाले अन्य Firebase मॉड्यूल इंपोर्ट करें. उदाहरण के लिए, Cloud Firestore और Authentication का इस्तेमाल करने के लिए:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. अपने ऐप्लिकेशन डेलिगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, शेयर किए गए इंस्टेंस FirebaseApp को कॉन्फ़िगर करें:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो आपको एक ऐप्लिकेशन डेलिगेट बनाना होगा. साथ ही, इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के ज़रिए अपनी App स्ट्रक्चर से जोड़ना होगा. आपको ऐप्लिकेशन के डेलिगेट स्विज़लिंग को भी बंद करना होगा. ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. अपने डेटाबेस का रेफ़रंस बनाएं और वह जगह तय करें जहां आपको लिखना है.
   अहम जानकारी: us-central1 डिफ़ॉल्ट डेटाबेस के अलावा किसी अन्य डेटाबेस का रेफ़रंस पाने के लिए, आपको database() (या Objective-C के लिए databaseWithURL) को डेटाबेस का यूआरएल पास करना होगा. us-central1 डिफ़ॉल्ट डेटाबेस के लिए, बिना किसी आर्ग्युमेंट के database() (या database) को कॉल किया जा सकता है.

   आपको Firebase कंसोल के Realtime Database सेक्शन में, Realtime Database का यूआरएल मिल सकता है. डेटाबेस की जगह के हिसाब से, डेटाबेस का यूआरएल इनमें से किसी एक फ़ॉर्म में होगा:

   • https://DATABASE_NAME.firebaseio.com (us-central1 में मौजूद डेटाबेस के लिए)
   • https://DATABASE_NAME.REGION.firebasedatabase.app (अन्य सभी जगहों पर मौजूद डेटाबेस के लिए)

   Swift

   ध्यान दें: यह Firebase प्रॉडक्ट, ऐप्लिकेशन क्लिप टारगेट पर उपलब्ध नहीं है.

   var ref: DatabaseReference!
   
   ref = Database.database().reference()

   Objective-C

   ध्यान दें: यह Firebase प्रॉडक्ट, ऐप्लिकेशन क्लिप टारगेट पर उपलब्ध नहीं है.

   @property (strong, nonatomic) FIRDatabaseReference *ref;
   
   self.ref = [[FIRDatabase database] reference];

अगले चरण

• Realtime Database के लिए, डेटा को स्ट्रक्चर करने का तरीका जानें.

• अपने डेटा को कई डेटाबेस इंस्टेंस में स्केल करें.

• डेटा को पढ़ना और उसमें बदलाव करना.

• Firebase कंसोल में अपना डेटाबेस देखें.

• अपना ऐप्लिकेशन लॉन्च करने के लिए:

  • App Check चालू करें, ताकि यह पक्का किया जा सके कि सिर्फ़ आपके ऐप्लिकेशन ही आपके डेटाबेस को ऐक्सेस कर सकें.

  • Google Cloud कंसोल में, अपने प्रोजेक्ट के लिए बजट सूचनाएं सेट अप करें.

  • Firebase कंसोल में इस्तेमाल और बिलिंग डैशबोर्ड पर नज़र रखें. इससे आपको यह पता चलेगा कि आपके प्रोजेक्ट का इस्तेमाल, Firebase की अलग-अलग सेवाओं में किस तरह किया जा रहा है. इस्तेमाल से जुड़ी ज़्यादा जानकारी के लिए, Realtime Database इस्तेमाल डैशबोर्ड पर जाएं.

  • Firebase लॉन्च करने की चेकलिस्ट देखें.