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

Swift Package Manager

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

Xcode के ज़रिए

Swift Package Manager के साथ काम करने के लिए, 26.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 मेनिफ़ेस्ट के ज़रिए, Firebase को Swift पैकेज में इंटिग्रेट करने के लिए, 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 26.2 और CocoaPods 1.12.0 या इसके बाद का वर्शन ज़रूरी है. CocoaPods का इस्तेमाल करके Firebase को इंस्टॉल करने का तरीका यहां बताया गया है:

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

    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. टारगेट की बिल्ड सेटिंग में, Other Linker Settings में -ObjC लिंकर फ़्लैग जोड़ें.