अपने ऐप्पल ऐप में फायरबेस इंस्टॉल करें

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

फायरबेस ऐप्पल एसडीके के v8.0.0 से शुरू होकर, फायरबेस का स्विफ्ट पैकेज मैनेजर समर्थन बीटा से बाहर है और आमतौर पर उपयोग के लिए उपलब्ध है। स्विफ्ट पैकेज मैनेजर उपयोगकर्ताओं के लिए CocoaPods की आवश्यकता नहीं है।

Xcode संस्करण 12.5 और उच्चतर के लिए, स्विफ्ट पैकेज मैनेजर अनुशंसित स्थापना विधि है।

एक्सकोड के माध्यम से

स्विफ्ट पैकेज मैनेजर समर्थन के लिए Xcode 12.5 या उच्चतर की आवश्यकता होती है।

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

2. Xcode में, फ़ाइल> स्विफ्ट पैकेज> पैकेज निर्भरता जोड़ें ... पर नेविगेट करके फायरबेस लाइब्रेरी स्थापित करें।

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

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

4. फायरबेस का वह संस्करण चुनें जिसका आप उपयोग करना चाहते हैं। नए प्रोजेक्ट के लिए, हम फायरबेस के नवीनतम संस्करण का उपयोग करने की सलाह देते हैं।

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

एक बार जब आप समाप्त कर लेंगे, तो एक्सकोड आपके पैकेज निर्भरताओं को हल करना शुरू कर देगा और उन्हें पृष्ठभूमि में डाउनलोड करना शुरू कर देगा।

पैकेज के माध्यम से Package.swift

Package.swift मेनिफेस्ट के माध्यम से फायरबेस को स्विफ्ट पैकेज में एकीकृत करने के लिए, आप फायरबेस को अपने पैकेज की dependencies सरणी में जोड़ सकते हैं। अधिक विवरण के लिए, स्विफ्ट पैकेज मैनेजर दस्तावेज देखें।

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 को आपके लक्ष्य की बिल्ड सेटिंग में -ObjC लिंकर फ़्लैग जोड़ने की आवश्यकता है, यदि इसे ट्रांज़िटिव रूप से शामिल किया गया है।

क्रैशलिटिक्स

Crashlytics के लिए आपको डीबग प्रतीकों को अपलोड करना होगा।

आप डिबग प्रतीकों को पोस्ट-बिल्ड स्वचालित रूप से अपलोड करने के लिए एक्सकोड के लिए रन स्क्रिप्ट बिल्ड चरण का उपयोग कर सकते हैं। यहां रन स्क्रिप्ट खोजें:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

प्रतीकों को अपलोड करने का एक अन्य विकल्प upload-symbols स्क्रिप्ट का उपयोग करना है। स्क्रिप्ट को अपनी प्रोजेक्ट फ़ाइल की उपनिर्देशिका में रखें (उदाहरण के लिए scripts/upload-symbols ), फिर सुनिश्चित करें कि स्क्रिप्ट निष्पादन योग्य है:

chmod +x scripts/upload-symbols

इस स्क्रिप्ट का उपयोग डीएसवाईएम फाइलों को मैन्युअल रूप से अपलोड करने के लिए किया जा सकता है। उपयोग नोट्स और स्क्रिप्ट के लिए अतिरिक्त निर्देशों के लिए, बिना किसी पैरामीटर के upload-symbols चलाएं।

कोकोपोड्स

फायरबेस स्विफ्ट पैकेज मैनेजर के अलावा CocoaPods के साथ इंस्टॉलेशन का समर्थन करता है।

Firebase के CocoaPods वितरण के लिए Xcode 12.5 और CocoaPods 1.10.0 या उच्चतर की आवश्यकता होती है। यहां CocoaPods का उपयोग करके Firebase को स्थापित करने का तरीका बताया गया है:

1. यदि आपके पास पहले से एक पॉडफाइल नहीं है तो एक पॉडफाइल बनाएं। अपनी प्रोजेक्ट निर्देशिका की जड़ से, निम्न आदेश चलाएँ:

   pod init

2. अपने पॉडफाइल में, उन फायरबेस पॉड्स को जोड़ें जिन्हें आप अपने ऐप में इस्तेमाल करना चाहते हैं।

   आप अपने ऐप्लिकेशन में समर्थित कोई भी Firebase उत्पाद जोड़ सकते हैं.

   एनालिटिक्स सक्षम

   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # 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 'Firebase/Auth'
   pod 'Firebase/Firestore'

   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 'Firebase/Auth'
   pod 'Firebase/Firestore'

   बाइनरी फायरबेस निर्भरताएं डिफ़ॉल्ट रूप से स्थिर ढांचे के रूप में एकीकृत होती हैं। यदि आप एक गतिशील ढांचे की निर्भरता के रूप में फायरबेस का उपयोग कर रहे हैं, तो सुनिश्चित करें कि आपने फ्रेमवर्क या लाइब्रेरी से फायरबेस का उपयोग करने के बारे में दस्तावेज़ीकरण पढ़ा है।

3. पॉड्स स्थापित करें, फिर प्रोजेक्ट को Xcode में देखने के लिए अपनी .xcworkspace फ़ाइल खोलें:

   pod install --repo-update

   open your-project.xcworkspace

उत्पाद-विशिष्ट विचार

कुछ Firebase उत्पादों को ठीक से काम करने के लिए अतिरिक्त एकीकरण चरणों की आवश्यकता होती है।

क्रैशलिटिक्स

Crashlytics के लिए आपको डीबग प्रतीकों को अपलोड करना होगा।

आप डिबग प्रतीकों को पोस्ट-बिल्ड स्वचालित रूप से अपलोड करने के लिए एक्सकोड के लिए रन स्क्रिप्ट बिल्ड चरण का उपयोग कर सकते हैं। यहां रन स्क्रिप्ट खोजें:

"${PODS_ROOT}/FirebaseCrashlytics/run"

कार्थेज

कार्थेज समर्थन प्रयोगात्मक है। कार्थेज के माध्यम से अपने ऐप में फायरबेस को शामिल करने के लिए गिटहब पर निर्देश देखें।

मैन्युअल रूप से एकीकृत करें

फायरबेस उन उपयोगकर्ताओं के लिए एक पूर्व-निर्मित बाइनरी एक्ससीफ्रेमवर्क वितरण प्रदान करता है जो एक निर्भरता प्रबंधक का उपयोग किए बिना फायरबेस को एकीकृत करना चाहते हैं। फायरबेस स्थापित करने के लिए:

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

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

3. अपने लक्ष्य की बिल्ड सेटिंग्स में अपनी Other Linker Settings में -ObjC लिंकर ध्वज जोड़ें।