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

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

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

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

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

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

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

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

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

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

अगर आपके पास पहले से कोई 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 (इसमें मनमुताबिक बनाने की सुविधा भी शामिल है).

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

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

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

मौजूदा क्लाउड प्रोजेक्ट

अगर आपको किसी मौजूदा 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 (इसमें मनमुताबिक बनाने की सुविधा भी शामिल है).

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

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

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

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

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

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

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

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

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

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

   • बंडल आईडी, Apple के नेटवर्क में मौजूद किसी ऐप्लिकेशन की खास तौर पर पहचान करता है.

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

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

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

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

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

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

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

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. SDK टूल का वह वर्शन चुनें जिसे आपको इस्तेमाल करना है.

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

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

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

पांचवां चरण: अपने ऐप्लिकेशन में Firebase को शुरू करना

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

1. FirebaseCore मॉड्यूल को अपने UIApplicationDelegate में इंपोर्ट करें. साथ ही, ऐसे अन्य 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 रिपॉज़िटरी

सेवा या प्रॉडक्ट	लाइब्रेरी / फ़्रेमवर्क का नाम	क्या आपको 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) को पहले "Vertex AI in Firebase" कहा जाता था और इसे FirebaseVertexAI मॉड्यूल के तहत उपलब्ध कराया जाता था. Firebase AI Logic को पहले FirebaseAI मॉड्यूल के तहत भी डिस्ट्रिब्यूट किया जाता था.}

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

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

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

फ़्रेमवर्क

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

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

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

   इंटिग्रेशन से जुड़े निर्देश, इनमें से किसी भी जगह पर देखे जा सकते हैं:

   • Firebase iOS SDK GitHub रिपॉज़िटरी में.
   • डाउनलोड की गई ZIP फ़ाइल में मौजूद README.md फ़ाइल में.

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

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

अगले चरण

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

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

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

• Firebase iOS कोडलैब की मदद से, Firebase का इस्तेमाल करने का अनुभव पाएं.

• 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 की मदद से जानें कि आपका ऐप्लिकेशन कब और क्यों क्रैश हो रहा है.