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

आवश्यक शर्तें

  • निम्नलिखित स्थापित करें:

    • एक्सकोड 14.1 या बाद का संस्करण
  • सुनिश्चित करें कि आपका प्रोजेक्ट इन आवश्यकताओं को पूरा करता है:

    • आपके प्रोजेक्ट को इन प्लेटफ़ॉर्म संस्करणों या बाद के संस्करण को लक्षित करना चाहिए:
      • आईओएस 11
      • मैकओएस 10.13
      • टीवीओएस 12
      • वॉचओएस 6
  • अपना ऐप चलाने के लिए एक भौतिक Apple डिवाइस सेट करें या सिम्युलेटर का उपयोग करें।

यदि आपके पास पहले से कोई Xcode प्रोजेक्ट नहीं है और आप केवल Firebase उत्पाद आज़माना चाहते हैं, तो आप हमारे क्विकस्टार्ट नमूनों में से एक डाउनलोड कर सकते हैं।

चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं

इससे पहले कि आप अपने ऐप्पल ऐप में फ़ायरबेस जोड़ सकें, आपको अपने ऐप से कनेक्ट करने के लिए एक फ़ायरबेस प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएँ।

चरण 2 : अपने ऐप को फायरबेस के साथ पंजीकृत करें

अपने ऐप्पल ऐप में फ़ायरबेस का उपयोग करने के लिए, आपको अपने ऐप को अपने फ़ायरबेस प्रोजेक्ट के साथ पंजीकृत करना होगा। अपने ऐप को पंजीकृत करने को अक्सर अपने ऐप को अपने प्रोजेक्ट में "जोड़ना" कहा जाता है।

  1. फायरबेस कंसोल पर जाएं।

  2. प्रोजेक्ट अवलोकन पृष्ठ के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए iOS+ आइकन पर क्लिक करें।

    यदि आपने पहले से ही अपने फायरबेस प्रोजेक्ट में एक ऐप जोड़ा है, तो प्लेटफ़ॉर्म विकल्प प्रदर्शित करने के लिए ऐप जोड़ें पर क्लिक करें।

  3. बंडल आईडी फ़ील्ड में अपने ऐप की बंडल आईडी दर्ज करें।

  4. (वैकल्पिक) अन्य ऐप जानकारी दर्ज करें: ऐप उपनाम और ऐप स्टोर आईडी

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

चरण 3 : एक फायरबेस कॉन्फ़िगरेशन फ़ाइल जोड़ें

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

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

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

चरण 4 : अपने ऐप में फायरबेस एसडीके जोड़ें

फायरबेस निर्भरता को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

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

    यदि आपके फायरबेस प्रोजेक्ट में Google Analytics सक्षम है, तो FirebaseAnalytics जोड़ना सुनिश्चित करें। आईडीएफए संग्रह क्षमता के बिना एनालिटिक्स के लिए, इसके बजाय FirebaseAnalyticsWithoutAdId जोड़ें।

समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरता को हल करना और डाउनलोड करना शुरू कर देगा।

चरण 5 : अपने ऐप में फायरबेस प्रारंभ करें

अंतिम चरण आपके एप्लिकेशन में इनिशियलाइज़ेशन कोड जोड़ना है। हो सकता है कि आपने अपने ऐप में फ़ायरबेस जोड़ने के हिस्से के रूप में यह पहले ही कर लिया हो। यदि आप क्विकस्टार्ट नमूना प्रोजेक्ट का उपयोग कर रहे हैं, तो यह आपके लिए किया गया है।

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

    स्विफ्टयूआई

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    तीव्र

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    उद्देश्य सी

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा किए गए इंस्टेंस को कॉन्फ़िगर करें:

    स्विफ्टयूआई

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    तीव्र

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    उद्देश्य सी

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. यदि आप स्विफ्टयूआई का उपयोग कर रहे हैं, तो आपको एक एप्लिकेशन प्रतिनिधि बनाना होगा और इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के माध्यम से अपने App स्ट्रक्चर में संलग्न करना होगा। आपको ऐप डेलीगेट स्विज़लिंग को भी अक्षम करना होगा। अधिक जानकारी के लिए स्विफ्टयूआई निर्देश देखें।

    स्विफ्टयूआई

    @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 के लिए फ़ायरबेस एसडीके शामिल किया है, तो आप फ़ायरबेस कंसोल पर सत्यापन भेजने के लिए अपना ऐप चला सकते हैं कि आपने फ़ायरबेस को सफलतापूर्वक इंस्टॉल कर लिया है।

इतना ही! आप अगले चरण पर जा सकते हैं।

हालाँकि, यदि आपको सेट अप करने में समस्या हो रही है, तो Apple प्लेटफ़ॉर्म समस्या निवारण और FAQ पर जाएँ।

उपलब्ध पुस्तकालय

यह अनुभाग Apple प्लेटफ़ॉर्म के लिए समर्थित Firebase उत्पादों को सूचीबद्ध करता है। इन Firebase Apple प्लेटफ़ॉर्म लाइब्रेरीज़ के बारे में और जानें:

सेवा या उत्पाद फली स्विफ्टपीएम लाइब्रेरीज़ एनालिटिक्स जोड़ें?
AdMob pod 'Google-Mobile-Ads-SDK' एन/ए
एनालिटिक्स pod 'FirebaseAnalytics' FirebaseAnalytics
ऐप जांचें pod 'FirebaseAppCheck' FirebaseAppCheck
ऐप वितरण pod 'FirebaseAppDistribution' FirebaseAppDistribution
प्रमाणीकरण pod 'FirebaseAuth' FirebaseAuth
क्लाउड फायरस्टोर pod 'FirebaseFirestore' FirebaseFirestore
फायरबेस क्लाइंट एसडीके के लिए क्लाउड फ़ंक्शंस pod 'FirebaseFunctions' FirebaseFunctions
क्लाउड मैसेजिंग pod 'FirebaseMessaging' FirebaseMessaging
घन संग्रहण pod 'FirebaseStorage' FirebaseStorage
क्रैशलिटिक्स pod 'FirebaseCrashlytics' FirebaseCrashlytics
गतिशील लिंक pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
इन-ऐप मैसेजिंग pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(आवश्यक)
फायरबेस संस्थापन pod 'FirebaseInstallations' FirebaseInstallations
फायरबेस एमएल कस्टम मॉडल एपीआई pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
निष्पादन की निगरानी pod 'FirebasePerformance' FirebasePerformance
रीयलटाइम डेटाबेस pod 'FirebaseDatabase' FirebaseDatabase
रिमोट कॉन्फिग pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

स्विफ्ट पैकेज मैनेजर का उपयोग किए बिना एकीकृत करें

यदि आप स्विफ्ट पैकेज मैनेजर का उपयोग नहीं करना चाहते हैं, तो भी आप कोकोपोड्स का उपयोग करके या सीधे फ्रेमवर्क आयात करके फायरबेस एसडीके का लाभ उठा सकते हैं।

कोकोपोड्स

हमारे गाइड में कोकोपोड्स एकीकरण के बारे में और जानें।

फ़्रेमवर्क

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

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

  2. फ़ाइल को अनज़िप करें, और फिर उन फ़्रेमवर्क को एकीकृत करें जिन्हें आप अपने ऐप में शामिल करना चाहते हैं।

    आप निम्नलिखित में से किसी भी स्थान पर एकीकरण निर्देश पा सकते हैं:

    फ़्रेमवर्क संस्करणों या निर्भरताओं के बारे में जानकारी के लिए, डाउनलोड किए गए ज़िप वितरण के भीतर METADATA.md फ़ाइल देखें।

  3. अपने लक्ष्य की बिल्ड सेटिंग्स में अपनी Other Linker Settings में -ObjC लिंकर ध्वज जोड़ें।

अगले कदम

फायरबेस के बारे में जानें:

अपने ऐप में फ़ायरबेस सेवाएँ जोड़ें: