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

Swift Package Manager

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

Xcode के ज़रिए

Swift Package Manager के साथ काम करने के लिए, Xcode का वर्शन 26.2 या उससे नया होना चाहिए.

  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 के ज़रिए

Firebase को Package.swift मेनिफ़ेस्ट के ज़रिए किसी Swift पैकेज में इंटिग्रेट करने के लिए, अपने पैकेज की dependencies कलेक्शन में Firebase जोड़ा जा सकता है. ज़्यादा जानकारी के लिए, the 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 का वर्शन 26.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 के साथ काम करने की सुविधा, अभी एक्सपेरिमेंटल है. Carthage के ज़रिए अपने ऐप्लिकेशन में Firebase को शामिल करने के लिए, GitHub पर दिए गए निर्देश देखें.

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

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

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

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

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