Apple ऐप्लिकेशन में Firebase इंस्टॉल करने के विकल्प

Swift पैकेज मैनेजर

Firebase, नए प्रोजेक्ट के लिए Swift Package Manager का सुझाव देता है.

Xcode के ज़रिए

Swift Package Manager से जुड़ी सहायता पाने के लिए, 14.1 या इसके बाद का वर्शन होना ज़रूरी है.

  1. अगर CocoaPods पर आधारित प्रोजेक्ट से माइग्रेट किया जा रहा है, तो अपने Xcode प्रोजेक्ट से CocoaPods को हटाने के लिए pod deintegrate चलाएं. CocoaPods की जनरेट की गई .xcworkspace फ़ाइल को बाद में सुरक्षित तरीके से मिटाया जा सकता है. अगर Firebase को किसी प्रोजेक्ट में पहली बार जोड़ा जा रहा है, तो इस चरण को अनदेखा किया जा सकता है.

  2. Xcode में, Firebase लाइब्रेरी इंस्टॉल करने के लिए, फ़ाइल > पैकेज जोड़ें पर जाएं

  3. स्क्रीन पर दिखने वाले प्रॉम्प्ट में, Firebase GitHub रिपॉज़िटरी चुनें:

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

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

  5. वे Firebase लाइब्रेरी चुनें जिन्हें आपको अपने ऐप्लिकेशन में शामिल करना है.

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

Package.swift के ज़रिए

Package.swift मेनिफ़ेस्ट की मदद से Firebase को Swift पैकेज में इंटिग्रेट करने के लिए, अपने पैकेज के dependencies कलेक्शन में Firebase जोड़ें. ज़्यादा जानकारी के लिए, Swift Package Manager का दस्तावेज़ देखें.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

इसके बाद, Firebase प्रॉडक्ट के हिसाब से बनाए गए किसी भी टारगेट में, उसे उस टारगेट के dependencies कलेक्शन में जोड़ें.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

प्रॉडक्ट के हिसाब से ध्यान देने वाली बातें

Firebase के कुछ प्रॉडक्ट को सही तरीके से काम करने के लिए, इंटिग्रेशन के कुछ और चरण अपनाने पड़ते हैं.

Google Analytics

अगर Google Analytics को ट्रांज़िट तरीके से शामिल किया गया है, तो आपको अपने टारगेट की बिल्ड सेटिंग में -ObjC लिंकर फ़्लैग जोड़ना होगा.

Crashlytics

Crashlytics के लिए आपको डीबग सिंबल अपलोड करने होंगे.

बिल्ड के बाद डीबग सिंबल अपने-आप अपलोड हो सकें, इसके लिए Xcode के लिए 'रन स्क्रिप्ट बिल्ड फ़ेज़' का इस्तेमाल किया जा सकता है. रन स्क्रिप्ट यहां देखें:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

सिंबल अपलोड करने के लिए upload-symbols स्क्रिप्ट का इस्तेमाल भी किया जा सकता है. स्क्रिप्ट को अपनी प्रोजेक्ट फ़ाइल की सबडायरेक्ट्री (उदाहरण के लिए, scripts/upload-symbols) में रखें. इसके बाद, पक्का करें कि स्क्रिप्ट पर एक्ज़ीक्यूट किया जा सकता हो:

chmod +x scripts/upload-symbols

इस स्क्रिप्ट का इस्तेमाल करके, dSYM फ़ाइलों को मैन्युअल तरीके से अपलोड किया जा सकता है. इस्तेमाल के नोट और स्क्रिप्ट के अन्य निर्देशों के लिए, upload-symbols को बिना किसी पैरामीटर के चलाएं.

CocoaPods

Firebase, Swift पैकेज मैनेजर के साथ-साथ CocoaPods की मदद से भी इंस्टॉल करने की सुविधा देता है.

Firebase के CocoaPods को उपलब्ध कराने के लिए, Xcode 14.1 और CocoaPods 1.12.0 या इसके बाद का वर्शन होना ज़रूरी है. CocoaPods का इस्तेमाल करके Firebase इंस्टॉल करने का तरीका यहां बताया गया है:

  1. अगर आपके पास पहले से कोई Podfile नहीं है, तो एक बनाएं. अपनी प्रोजेक्ट डायरेक्ट्री के रूट से, यह कमांड चलाएं:

    pod init

  2. अपनी Podfile में, वे Firebase पॉड जोड़ें जिन्हें आपको अपने ऐप्लिकेशन में इस्तेमाल करना है.

    अपने ऐप्लिकेशन में, इस्तेमाल किए जा सकने वाले Firebase प्रॉडक्ट में से किसी भी प्रॉडक्ट को जोड़ा जा सकता है.

    Analytics चालू किया गया 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

    Apple के उपयोगकर्ता की निजता और डेटा का इस्तेमाल और App Tracking Transparency दस्तावेज़ में, IDFA के बारे में ज़्यादा जानें. यह डिवाइस लेवल पर विज्ञापन के लिए आइडेंटिफ़ायर है.

    Analytics चालू नहीं है 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. पॉड इंस्टॉल करें, फिर प्रोजेक्ट को Xcode में देखने के लिए अपनी .xcworkspace फ़ाइल खोलें:

    pod install --repo-update
    open your-project.xcworkspace

प्रॉडक्ट के हिसाब से ध्यान देने वाली बातें

Firebase के कुछ प्रॉडक्ट को सही तरीके से काम करने के लिए, इंटिग्रेशन के कुछ और चरण अपनाने पड़ते हैं.

Crashlytics

Crashlytics के लिए आपको डीबग सिंबल अपलोड करने होंगे.

बिल्ड के बाद डीबग सिंबल अपने-आप अपलोड हो सकें, इसके लिए Xcode के लिए 'रन स्क्रिप्ट बिल्ड फ़ेज़' का इस्तेमाल किया जा सकता है. रन स्क्रिप्ट यहां देखें:

"${PODS_ROOT}/FirebaseCrashlytics/run"

कार्थेज

कार्थेज सहायता को अभी आज़माया जा रहा है. Carthage के ज़रिए अपने ऐप्लिकेशन में Firebase शामिल करने के लिए, GitHub पर निर्देश देखें.

मैन्युअल तरीके से इंटिग्रेट करना

Firebase उन उपयोगकर्ताओं को पहले से मौजूद बाइनरी XCFramework डिस्ट्रिब्यूशन उपलब्ध कराता है जो किसी डिपेंडेंसी मैनेजर का इस्तेमाल किए बिना Firebase को इंटिग्रेट करना चाहते हैं. Firebase इंस्टॉल करने के लिए:

  1. फ़्रेमवर्क SDK टूल की ZIP फ़ाइल डाउनलोड करें. इस फ़ाइल में सभी Firebase SDK टूल के लिए उपलब्ध सभी टारगेट आर्किटेक्चर के लिए आर्किटेक्चर स्लाइस मौजूद हैं. इसलिए, डाउनलोड होने में कुछ समय लग सकता है.

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

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