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

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

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

    • Xcode 15.2 या उसके बाद का वर्शन
  • पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो:

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

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

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

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

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

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

  1. Firebase console पर जाएं.

  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 Package Manager का इस्तेमाल करें.

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

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

प्रोसेस पूरी होने के बाद, 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 लाइब्रेरी Google Analytics.">Analytics जोड़ें?
AdMob pod 'Google-Mobile-Ads-SDK' लागू नहीं
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
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
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

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

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

CocoaPods

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

फ़्रेमवर्क

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

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

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

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

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

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

अगले चरण

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

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

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

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

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

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

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

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

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