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

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

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

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

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

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

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

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

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

  • Apple का कोई फ़िज़िकल डिवाइस सेट अप करें.
  • अपने Apple डेवलपर खाते के लिए, 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 (इसमें उपयोगकर्ताओं के हिसाब से कॉन्टेंट दिखाने की सुविधा भी शामिल है).

   कोई मौजूदा 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 में ऐप्लिकेशन का कोई दूसरा नाम और ऐप्लिकेशन स्टोर आईडी का इस्तेमाल कैसे किया जाता है?

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

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

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

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

1. Firebase के Apple प्लैटफ़ॉर्म की कॉन्फ़िगरेशन फ़ाइल (GoogleService-Info.plist) पाने के लिए, GoogleService-Info.plist डाउनलोड करें पर क्लिक करें.

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

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

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

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

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

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

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

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

अपने Apple प्रोजेक्ट में Firebase SDK टूल जोड़ने के अलग-अलग तरीकों के बारे में जानने के लिए,

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

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

3. SDK टूल का वह वर्शन चुनें जिसका इस्तेमाल करना है.

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

सेवा या प्रॉडक्ट	पॉड	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 कस्टम मॉडल एपीआई	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
Performance Monitoring	pod 'FirebasePerformance'	FirebasePerformance
Realtime Database	pod 'FirebaseDatabase'	FirebaseDatabase
Remote Config	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

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

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

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

CocoaPods

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

फ़्रेमवर्क

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

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

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

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

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

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

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

अगले चरण

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

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

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

• Firebase iOS के लिए Codelab की मदद से, Firebase का इस्तेमाल करना सीखें.

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