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

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

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

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

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

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

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

Firebase को अपने Apple ऐप्लिकेशन में जोड़ने से पहले, आपको एक 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
  4. SDK टूल का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है.
  5. वे Firebase लाइब्रेरी चुनें जिनका आपको इस्तेमाल करना है.

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

यह काम पूरा होने पर, 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. कॉन्फ़िगर करें FirebaseApp आपके ऐप्लिकेशन डेलिगेट के में शेयर किया गया इंस्टेंस application(_:didFinishLaunchingWithOptions:) तरीका:

    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 के ज़रिए अपने App निर्देश को या NSApplicationDelegateAdaptor. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. इसके लिए ज़्यादा जानकारी के लिए, 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 प्लैटफ़ॉर्म लाइब्रेरी के बारे में ज़्यादा जानकारी यहां दी गई है:

सेवा या प्रॉडक्ट पॉड 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 लागू नहीं FirebaseVertexAI-Preview

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

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

CocoaPods

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

फ़्रेमवर्क

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

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

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

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

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

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

अगले चरण

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

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

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

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

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

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

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

  • इससे सूचनाएं भेजें Cloud Messaging.

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