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

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

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

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

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

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

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

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

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

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

• अपने Google खाते का इस्तेमाल करके, Firebase में साइन इन करें.

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

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

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

Firebase प्रोजेक्ट बनाना

1. Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें.

   • किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase संसाधन जोड़ने के लिए, उसका प्रोजेक्ट नाम डालें या उसे ड्रॉपडाउन मेन्यू से चुनें.

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

2. अगर प्रॉम्प्ट मिलता है, तो Firebase की शर्तें पढ़ें और उन्हें स्वीकार करें.

3. जारी रखें पर क्लिक करें.

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

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

5. प्रोजेक्ट बनाएं पर क्लिक करें. अगर आपको किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase जोड़ना है, तो 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 में ऐप्लिकेशन के निकनेम और App Store आईडी का इस्तेमाल कैसे किया जाता है?

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

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

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

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

1. अपने ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist) पाने के लिए, 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 टूल शामिल किया है, तो अपने ऐप्लिकेशन को चलाएं. इससे Google Analytics कंसोल को यह पुष्टि करने में मदद मिलेगी कि आपने Firebase को सही तरीके से इंस्टॉल कर लिया है.Firebase

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

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

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

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

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

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

सेवा या प्रॉडक्ट	पॉड	SwiftPM लाइब्रेरी	Analytics जोड़ना है?
AdMob	pod 'Google-Mobile-Ads-SDK'	लागू नहीं
Firebase AI Logic 1	pod 'FirebaseAI'	FirebaseAI
Analytics	pod 'FirebaseAnalytics'	FirebaseAnalytics
App Check	pod 'FirebaseAppCheck'	FirebaseAppCheck
App Distribution	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
Authentication	pod 'FirebaseAuth'	FirebaseAuth
Cloud Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
Cloud Functions for Firebase Client SDK	pod 'FirebaseFunctions'	FirebaseFunctions
Cloud Messaging	pod 'FirebaseMessaging'	FirebaseMessaging
Cloud Storage	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
Data Connect	लागू नहीं	FirebaseDataConnect
Dynamic Links	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
In-App Messaging	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(ज़रूरी है)
Firebase इंस्टॉल	pod 'FirebaseInstallations'	FirebaseInstallations
Firebase ML Custom Model APIs	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
Performance Monitoring	pod 'FirebasePerformance'	FirebasePerformance
Realtime Database	pod 'FirebaseDatabase'	FirebaseDatabase
Remote Config	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

^{1 Firebase AI Logic को पहले pod 'FirebaseVertexAI' पॉड और SwiftPM लाइब्रेरी FirebaseVertexAI के साथ "Vertex AI in Firebase" कहा जाता था.}

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

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

CocoaPods

हमारी गाइड में, CocoaPods इंटिग्रेशन के बारे में ज़्यादा जानें.

फ़्रेमवर्क

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

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

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

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

   • Firebase iOS SDK GitHub repository में.
   • डाउनलोड किए गए zip डिस्ट्रिब्यूशन में मौजूद README.md फ़ाइल में.

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

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

अगले चरण

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

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

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

• Firebase iOS Codelab का इस्तेमाल करके देखें.

• GitHub में ओपन सोर्स कोड एक्सप्लोर करें.

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

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

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

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

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

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

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

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

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

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

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

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