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

Swift Package Manager

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

Xcode से

Swift Package Manager के साथ काम करने के लिए, 15.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 के ज़रिए

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 15.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 ‘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'

   डिवाइस-लेवल विज्ञापन आइडेंटिफ़ायर, IDFA के बारे में ज़्यादा जानने के लिए, 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. फ़्रेमवर्क SDK टूल का zip डाउनलोड करें. इस फ़ाइल में, सभी Firebase SDK टूल के लिए उपलब्ध सभी टारगेट आर्किटेक्चर के आर्किटेक्चर स्लाइस शामिल होते हैं. इसलिए, इसे डाउनलोड करने में कुछ समय लग सकता है.

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

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