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

Swift Package Manager

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

Xcode की मदद से

Swift Package Manager के साथ काम करने के लिए, iOS 16.2 या उसके बाद का वर्शन ज़रूरी है.

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

  2. Xcode में, Firebase लाइब्रेरी इंस्टॉल करने के लिए, File > Add Packages पर जाएं.

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

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

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

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

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

Package.swift के ज़रिए

Package.swift मेनिफ़ेस्ट के ज़रिए, Swift पैकेज में Firebase को इंटिग्रेट करने के लिए, Firebase को अपने पैकेज के dependencies ऐरे में जोड़ा जा सकता है. ज़्यादा जानकारी के लिए, 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 16.2 और 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 FirebaseAnalytics/Core

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

    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 के साथ काम करने की सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है. Carthage के ज़रिए अपने ऐप्लिकेशन में Firebase को शामिल करने के लिए, GitHub पर दिए गए निर्देश देखें.

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

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

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

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

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