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

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

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

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

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

    • आपके प्रोजेक्ट को प्लैटफ़ॉर्म के इन वर्शन या इसके बाद के वर्शन को टारगेट करना होगा:
      • iOS 11
      • macOS 10.13 वर्शन
      • TVOS 12
      • WatchOS 6

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ें पर जाएं.
  2. जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. SDK टूल का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है.

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

    अगर आपके Firebase प्रोजेक्ट में Google Analytics चालू है, तो FirebaseAnalytics जोड़ना न भूलें. जिन Analytics में IDFA कलेक्शन की सुविधा नहीं है उनके लिए FirebaseAnalyticsWithoutAdId जोड़ें.

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

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

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

  1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल को इंपोर्ट करें. साथ ही, ऐसे सभी Firebase मॉड्यूल को इंपोर्ट करें जिनका इस्तेमाल आपके ऐप्लिकेशन का ऐक्सेस मैनेज करता है. उदाहरण के लिए, Cloud Firestore और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

    स्विफ़्टयूआई

    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 शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

    स्विफ़्टयूआई

    // 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 के निर्देश देखें.

    स्विफ़्टयूआई

    @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 रेपो

सेवा या प्रॉडक्ट पॉड SwiftPM लाइब्रेरी क्या आपको Analytics जोड़ना है?
AdMob pod 'Google-Mobile-Ads-SDK' लागू नहीं
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
ऐप्लिकेशन की जांच pod 'FirebaseAppCheck' FirebaseAppCheck
ऐप्लिकेशन डिस्ट्रिब्यूशन pod 'FirebaseAppDistribution' FirebaseAppDistribution
पुष्टि करना pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase क्लाइंट SDK टूल pod 'FirebaseFunctions' FirebaseFunctions
क्लाउड से मैसेज pod 'FirebaseMessaging' FirebaseMessaging
क्लाउड स्टोरेज pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
डाइनैमिक लिंक pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
इन-ऐप्लिकेशन मैसेज pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ज़रूरी है)
Firebase इंस्टॉल करना pod 'FirebaseInstallations' FirebaseInstallations
Firebase एमएल कस्टम मॉडल एपीआई pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
परफ़ॉर्मेंस मॉनिटर करना pod 'FirebasePerformance' FirebasePerformance
रीयलटाइम डेटाबेस pod 'FirebaseDatabase' FirebaseDatabase
रिमोट कॉन्फ़िगरेशन pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Firebase के लिए Vertex AI लागू नहीं FirebaseVertexAI-Preview

Swift पैकेज मैनेजर का इस्तेमाल किए बिना इंटिग्रेट करें

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

CocoaPods

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

फ़्रेमवर्क

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

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

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

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

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

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

अगले चरण

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

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

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

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

  • Cloud Firestore या रीयलटाइम डेटाबेस के साथ उपयोगकर्ता की जानकारी जैसा डेटा सेव करें.

  • Cloud Storage के साथ फ़ोटो और वीडियो जैसी फ़ाइलें सेव करने की सुविधा.

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

  • क्लाउड से मैसेज के ज़रिए सूचनाएं भेजें.

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