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

स्विफ़्ट पैकेज मैनेजर

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 Package Manager के साथ-साथ CocoaPods का इस्तेमाल करके इंस्टॉलेशन भी किया जा सकता है.

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

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

    pod init

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

    अपने ऐप्लिकेशन में, साथ काम करने वाले 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 के उपयोगकर्ता की निजता और डेटा के इस्तेमाल और ऐप्लिकेशन ट्रैकिंग ट्रांसपेरंसी दस्तावेज़ में, डिवाइस लेवल पर विज्ञापन के लिए आइडेंटिफ़ायर आईडी IDFA के बारे में ज़्यादा जानें.

    आंकड़े की सुविधा चालू नहीं है 

    # 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"

कार्थेज

कार्थेज सहायता, एक्सपेरिमेंट के तौर पर शुरू की गई है. कार्थेज के ज़रिए अपने ऐप्लिकेशन में Firebase शामिल करने के लिए, GitHub पर निर्देश देखें.

मैन्युअल तौर पर इंटिग्रेट करें

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

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

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

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