अपने Apple प्रोजेक्ट में Firebase जोड़ना

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

• इन्हें इंस्टॉल करें:

  • Xcode 26.2 या उसके बाद के वर्शन

• पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो:

  • आपका प्रोजेक्ट, इन प्लैटफ़ॉर्म वर्शन या इसके बाद के वर्शन को टारगेट करना चाहिए:
    • iOS 15
    • macOS 10.15
    • tvOS 15
    • watchOS 7

• अपने ऐप्लिकेशन को चलाने के लिए, कोई फ़िज़िकल Apple डिवाइस सेट अप करें या सिम्युलेटर का इस्तेमाल करें.

  क्या आपको Cloud Messaging का इस्तेमाल करना है?

  Apple प्लैटफ़ॉर्म पर Cloud Messaging के लिए, यहां दी गई ज़रूरी शर्तें पूरी करना ज़रूरी है:

  • Apple के फ़िज़िकल डिवाइस को सेट अप करें.
  • अपने Apple Developer खाते के लिए, Apple Push Notification Authentication Key पाएं.
  • ऐप्लिकेशन > सुविधाएं में जाकर, Xcode में पुश नोटिफ़िकेशन चालू करें.

अगर आपके पास पहले से कोई Xcode प्रोजेक्ट नहीं है और आपको सिर्फ़ Firebase प्रॉडक्ट आज़माना है, तो हमारे क्विकस्टार्ट सैंपल में से कोई एक डाउनलोड करें.

पहला चरण: Firebase प्रोजेक्ट बनाना

अपने Apple ऐप्लिकेशन में Firebase जोड़ने से पहले, आपको एक Firebase प्रोजेक्ट बनाना होगा, ताकि उसे अपने ऐप्लिकेशन से कनेक्ट किया जा सके. Firebase प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी पर जाएं.

Firebase प्रोजेक्ट बनाने के निर्देश देखें

Firebase या Cloud का नया उपयोगकर्ता

अगर आपने Firebase या Google Cloud का इस्तेमाल पहले कभी नहीं किया है, तो यह तरीका अपनाएं.
अगर आपको पूरी तरह से नया Firebase प्रोजेक्ट (और उसका Google Cloud प्रोजेक्ट) बनाना है, तो भी यह तरीका अपनाया जा सकता है.

1. Firebase console में साइन इन करें.
2. नया Firebase प्रोजेक्ट बनाने के लिए, बटन पर क्लिक करें.

3. टेक्स्ट फ़ील्ड में, प्रोजेक्ट का नाम डालें.

   अगर आप किसी Google Cloud संगठन का हिस्सा हैं, तो आपके पास यह चुनने का विकल्प होता है कि आपको अपना प्रोजेक्ट किस फ़ोल्डर में बनाना है.

4. अगर प्रॉम्प्ट मिलता है, तो Firebase की शर्तें पढ़ें और उन्हें स्वीकार करें. इसके बाद, जारी रखें पर क्लिक करें.
5. (ज़रूरी नहीं) Firebase कंसोल में एआई की मदद से काम करने की सुविधा चालू करें. इसे "Firebase में Gemini" कहा जाता है. इससे आपको शुरू करने और डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिल सकती है.

6. (ज़रूरी नहीं) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें. इससे इन Firebase प्रॉडक्ट का इस्तेमाल करके, बेहतर अनुभव मिलता है: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging, और Remote Config (इसमें Personalization शामिल है).

   कोई मौजूदा Google Analytics खाता चुनें या नया खाता बनाएं. अगर नया खाता बनाया जाता है, तो Analytics रिपोर्टिंग की जगह चुनें. इसके बाद, अपने प्रोजेक्ट के लिए डेटा शेयर करने की सेटिंग और Google Analytics शर्तें स्वीकार करें.

7. प्रोजेक्ट बनाएं पर क्लिक करें.

Firebase आपका प्रोजेक्ट बनाता है, कुछ शुरुआती संसाधन उपलब्ध कराता है, और ज़रूरी एपीआई चालू करता है. यह प्रोसेस पूरी होने के बाद, आपको Firebase कंसोल में अपने Firebase प्रोजेक्ट की खास जानकारी वाले पेज पर ले जाया जाएगा.

मौजूदा Cloud प्रोजेक्ट

अगर आपको किसी मौजूदा Google Cloud प्रोजेक्ट के साथ Firebase का इस्तेमाल शुरू करना है, तो यह तरीका अपनाएं. मौजूदा Google Cloud प्रोजेक्ट में"Firebase जोड़ने" के बारे में ज़्यादा जानें और इससे जुड़ी समस्या हल करें.

1. उस खाते से Firebase कंसोल में साइन इन करें जिससे आपको मौजूदा Google Cloud प्रोजेक्ट का ऐक्सेस मिलता है.
2. नया Firebase प्रोजेक्ट बनाने के लिए, बटन पर क्लिक करें.
3. पेज पर सबसे नीचे, Google Cloud प्रोजेक्ट में Firebase जोड़ें पर क्लिक करें.
4. टेक्स्ट फ़ील्ड में, मौजूदा प्रोजेक्ट का प्रोजेक्ट का नाम डालना शुरू करें. इसके बाद, दिखाई गई सूची से प्रोजेक्ट चुनें.
5. प्रोजेक्ट खोलें पर क्लिक करें.
6. अगर प्रॉम्प्ट मिलता है, तो Firebase की शर्तें पढ़ें और उन्हें स्वीकार करें. इसके बाद, जारी रखें पर क्लिक करें.
7. (ज़रूरी नहीं) Firebase कंसोल में एआई की मदद से काम करने की सुविधा चालू करें. इसे "Firebase में Gemini" कहा जाता है. इससे आपको शुरू करने और डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिल सकती है.

8. (ज़रूरी नहीं) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें. इससे इन Firebase प्रॉडक्ट का इस्तेमाल करके, बेहतर अनुभव मिलता है: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging, और Remote Config (इसमें Personalization शामिल है).

   कोई मौजूदा Google Analytics खाता चुनें या नया खाता बनाएं. अगर नया खाता बनाया जाता है, तो Analytics रिपोर्टिंग की जगह चुनें. इसके बाद, अपने प्रोजेक्ट के लिए डेटा शेयर करने की सेटिंग और Google Analytics शर्तें स्वीकार करें.

9. Firebase जोड़ें पर क्लिक करें.

Firebase आपके मौजूदा प्रोजेक्ट में Firebase जोड़ता है. यह प्रोसेस पूरी होने के बाद, आपको Firebase कंसोल में अपने Firebase प्रोजेक्ट की खास जानकारी वाले पेज पर ले जाया जाएगा.

दूसरा चरण: अपने ऐप्लिकेशन को Firebase के साथ रजिस्टर करना

अपने Apple ऐप्लिकेशन में Firebase का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को Firebase प्रोजेक्ट में रजिस्टर करना होगा. ऐप्लिकेशन को रजिस्टर करने का मतलब, अक्सर अपने ऐप्लिकेशन को अपने प्रोजेक्ट में "जोड़ना" होता है.

1. Firebase कंसोल पर जाएं.

2. सेटअप वर्कफ़्लो लॉन्च करने के लिए, प्रोजेक्ट की खास जानकारी वाले पेज के बीच में मौजूद iOS+ आइकॉन पर क्लिक करें.

   अगर आपने पहले से ही अपने Firebase प्रोजेक्ट में कोई ऐप्लिकेशन जोड़ा है, तो प्लैटफ़ॉर्म के विकल्प दिखाने के लिए, ऐप्लिकेशन जोड़ें पर क्लिक करें.

3. बंडल आईडी फ़ील्ड में, अपने ऐप्लिकेशन का बंडल आईडी डालें.

   बंडल आईडी क्या होता है और यह कहां मिलता है?

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

   • अपना बंडल आईडी ढूंढें: Xcode में अपना प्रोजेक्ट खोलें. इसके बाद, प्रोजेक्ट नेविगेटर में सबसे ऊपर मौजूद ऐप्लिकेशन को चुनें. इसके बाद, General टैब को चुनें.

     बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू, बंडल आईडी होती है. उदाहरण के लिए, com.yourcompany.yourproject.

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

4. (ज़रूरी नहीं) ऐप्लिकेशन की अन्य जानकारी डालें: ऐप्लिकेशन का निकनेम और App Store आईडी.

   Firebase में ऐप्लिकेशन के निकनेम और App Store आईडी का इस्तेमाल कैसे किया जाता है?

   • ऐप्लिकेशन का निकनेम: यह एक इंटरनल आइडेंटिफ़ायर होता है, जो सिर्फ़ आपको Firebase कंसोल में दिखता है

   • App Store आईडी: इसका इस्तेमाल Firebase Dynamic Links इन कामों के लिए करता है: लोगों को आपके App Store पेज पर रीडायरेक्ट करना. साथ ही, इसका इस्तेमाल Google Analytics इन कामों के लिए करता है: कन्वर्ज़न इवेंट को Google Ads में इंपोर्ट करना. अगर आपके ऐप्लिकेशन का App Store आईडी अभी तक नहीं है, तो इसे बाद में प्रोजेक्ट सेटिंग में जोड़ा जा सकता है.

5. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

तीसरा चरण: Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ना

1. अपने ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist) पाने के लिए, Download GoogleService-Info.plist पर क्लिक करें.

   आपको इस कॉन्फ़िगरेशन फ़ाइल के बारे में क्या जानने की ज़रूरत है?

   • Firebase कॉन्फ़िगरेशन फ़ाइल में, आपके प्रोजेक्ट और ऐप्लिकेशन के लिए यूनीक आइडेंटिफ़ायर होते हैं. हालांकि, ये आइडेंटिफ़ायर गोपनीय नहीं होते. इस कॉन्फ़िगरेशन फ़ाइल के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी लेख पढ़ें.

   • आपके पास Firebase कॉन्फ़िगरेशन फ़ाइल को किसी भी समय फिर से डाउनलोड करने का विकल्प होता है.

   • पक्का करें कि कॉन्फ़िगरेशन फ़ाइल के नाम में (2) जैसे अतिरिक्त वर्ण न जोड़े गए हों.

2. अपनी कॉन्फ़िगरेशन फ़ाइल को अपने Xcode प्रोजेक्ट के रूट में ले जाएं. अगर आपसे कहा जाए, तो सभी टारगेट में कॉन्फ़िगरेशन फ़ाइल जोड़ने का विकल्प चुनें.

अगर आपके प्रोजेक्ट में एक से ज़्यादा बंडल आईडी हैं, तो आपको हर बंडल आईडी को Firebase कंसोल में रजिस्टर किए गए ऐप्लिकेशन से जोड़ना होगा. इससे हर ऐप्लिकेशन के पास अपनी GoogleService-Info.plist फ़ाइल होगी.

चौथा चरण: अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ना

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

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

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

3. एसडीके का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है.

4. Firebase की वे लाइब्रेरी चुनें जिनका आपको इस्तेमाल करना है.

   अगर आपके Firebase प्रोजेक्ट में Google Analytics चालू है, तो पक्का करें कि आपने FirebaseAnalytics जोड़ा हो. इससे आपको सभी आंकड़ों से जुड़ी सुविधाएं मिलती हैं. अलग-अलग सुविधाओं को भी चुना जा सकता है. ज़्यादा जानकारी के लिए, Firebase SDK में मॉड्यूल के नए संगठन Google Analytics के बारे में अक्सर पूछे जाने वाले सवाल देखें.

इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करना शुरू कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा.

पांचवां चरण: अपने ऐप्लिकेशन में 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. अगर आपने Google Analytics के लिए Firebase SDK टूल शामिल किया है, तो अपने ऐप्लिकेशन को चलाकर Firebase कंसोल को यह पुष्टि भेजी जा सकती है कि आपने Firebase को सही तरीके से इंस्टॉल कर लिया है.

बस हो गया! सीधे अगले चरणों पर जाएं.

अगर आपको सेट अप करने में समस्या आ रही है, तो Apple प्लैटफ़ॉर्म से जुड़ी समस्याओं को हल करने के तरीके और अक्सर पूछे जाने वाले सवाल पर जाएं.

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

इस सेक्शन में, Apple प्लैटफ़ॉर्म के लिए काम करने वाले Firebase प्रॉडक्ट की सूची दी गई है. Firebase Apple प्लैटफ़ॉर्म की इन लाइब्रेरी के बारे में ज़्यादा जानें:

• रेफ़रंस के लिए दस्तावेज़ (Swift | Obj-C)

• Firebase Apple प्लैटफ़ॉर्म SDK टूल का GitHub repo

सेवा या प्रॉडक्ट	लाइब्रेरी / फ़्रेमवर्क का नाम	Analytics जोड़ना है?
AdMob	GoogleMobileAds
Firebase AI Logic 1	FirebaseAILogic
Analytics	FirebaseAnalytics
App Check	FirebaseAppCheck
App Distribution	FirebaseAppDistribution
Authentication	FirebaseAuth
Cloud Firestore	FirebaseFirestore
Cloud Functions for Firebase Client SDK	FirebaseFunctions
Cloud Messaging	FirebaseMessaging
Cloud Storage	FirebaseStorage
Crashlytics	FirebaseCrashlytics
In-App Messaging	FirebaseInAppMessaging	(ज़रूरी है)
Firebase इंस्टॉलेशन	FirebaseInstallations
Performance Monitoring	FirebasePerformance
Realtime Database	FirebaseDatabase
Remote Config	FirebaseRemoteConfig
SQL Connect 2	FirebaseDataConnect
पुरानी हो चुकी या काम न करने वाली लाइब्रेरी
Dynamic Links	FirebaseDynamicLinks
Firebase ML कस्टम मॉडल एपीआई	FirebaseMLModelDownloader

^{1 Firebase AI Logic (FirebaseAILogic) को पहले "Firebase में Vertex AI" कहा जाता था. इसे FirebaseVertexAI मॉड्यूल के तहत डिस्ट्रिब्यूट किया जाता था. Firebase AI Logic को पहले FirebaseAI मॉड्यूल के तहत भी डिस्ट्रिब्यूट किया जाता था.}

^{2 Firebase SQL Connect को पहले "Firebase Data Connect" कहा जाता था.}

Swift Package Manager का इस्तेमाल किए बिना इंटिग्रेट करना

अगर आपको Swift Package Manager का इस्तेमाल नहीं करना है, तो भी Firebase को इंटिग्रेट किया जा सकता है. इसके लिए, पहले से कंपाइल किए गए फ़्रेमवर्क को सीधे तौर पर इंपोर्ट करें.

फ़्रेमवर्क

अब यह ZIP फ़ाइल, iOS प्लैटफ़ॉर्म के साथ-साथ .xcframework फ़ाइलों के साथ भी काम करती है. ज़्यादा जानकारी के लिए, GitHub पर Firebase Apple प्लैटफ़ॉर्म SDK टूल का README देखें .

1. फ़्रेमवर्क एसडीके टूल की ज़िप फ़ाइल डाउनलोड करें. यह फ़ाइल करीब 200 एमबी की है. इसे डाउनलोड होने में कुछ समय लग सकता है.

2. फ़ाइल को अनज़िप करें. इसके बाद, उन फ़्रेमवर्क को इंटिग्रेट करें जिन्हें आपको अपने ऐप्लिकेशन में शामिल करना है.

   इंटिग्रेशन से जुड़े निर्देश यहां दिए गए हैं:

   • Firebase iOS SDK GitHub repository में.
   • डाउनलोड किए गए ZIP फ़ाइल में मौजूद README.md फ़ाइल में.

   फ़्रेमवर्क के वर्शन या डिपेंडेंसी के बारे में जानकारी पाने के लिए, डाउनलोड की गई ZIP फ़ाइल में मौजूद METADATA.md फ़ाइल देखें.

3. टारगेट की बिल्ड सेटिंग में, -ObjC लिंकर फ़्लैग Other Linker Flags जोड़ें.

अगले चरण

Firebase के बारे में जानें:

• Firebase प्रोजेक्ट और प्रोजेक्ट के सबसे सही तरीकों के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी पर जाएं.

• Firebase के सैंपल ऐप्लिकेशन एक्सप्लोर करें.

• Firebase iOS Codelab का इस्तेमाल करके, व्यावहारिक अनुभव पाएं.

• GitHub में ओपन सोर्स कोड देखें.

• ऐप्लिकेशन लॉन्च करने की तैयारी करें:

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

• क्या आपको Firebase और Apple प्रोजेक्ट से जुड़ी कोई समस्या आ रही है? Apple प्लैटफ़ॉर्म से जुड़ी समस्या हल करने के तरीके और अक्सर पूछे जाने वाले सवाल देखें.

अपने ऐप्लिकेशन में Firebase सेवाएं जोड़ें:

• Firebase AI Logic का इस्तेमाल करके, Gemini मॉडल की मदद से जनरेटिव एआई की सुविधाएं बनाएं.

• Analytics की मदद से, उपयोगकर्ता के व्यवहार के बारे में अहम जानकारी पाएं.

• Authentication की मदद से, उपयोगकर्ता की पुष्टि करने की सुविधा सेट अप करें.

• Cloud Firestore या Realtime Database की मदद से, उपयोगकर्ता की जानकारी जैसे डेटा को सेव करना.

• Cloud Storage का इस्तेमाल करके, फ़ोटो और वीडियो जैसी फ़ाइलें सेव करें.

• Cloud Functions की मदद से, सुरक्षित एनवायरमेंट में चलने वाले बैकएंड कोड को ट्रिगर करें.

• Cloud Messaging की मदद से सूचनाएं भेजें.

• जानें कि Crashlytics का इस्तेमाल करने पर, आपका ऐप्लिकेशन कब और क्यों क्रैश हो रहा है.