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

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

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

फायरबेस संस्करण 8 और उच्चतर के लिए, स्विफ्ट पैकेज मैनेजर अनुशंसित इंस्टॉलेशन विधि है।

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

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

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

2. Xcode में, File > Add Packages पर नेविगेट करके Firebase लाइब्रेरी स्थापित करें

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

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

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

5. उन फायरबेस लाइब्रेरी को चुनें जिन्हें आप अपने ऐप में शामिल करना चाहते हैं।

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

Package.swift माध्यम से। तेज

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

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

फिर किसी भी लक्ष्य में जो फायरबेस उत्पाद पर निर्भर करता है, उसे उस लक्ष्य की dependencies सरणी में जोड़ें।

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

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

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

गूगल विश्लेषिकी

यदि सकर्मक रूप से शामिल किया गया है तो 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 चलाएं।

कोकोपोड्स

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

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

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

   pod init

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

   आप अपने ऐप में कोई भी समर्थित फायरबेस उत्पाद जोड़ सकते हैं।

   विश्लेषिकी सक्षम

   # 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'

   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 'FirebaseAuth'
   pod 'FirebaseFirestore'

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

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

   pod install --repo-update

   open your-project.xcworkspace

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

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

कार्थेज

कार्थेज समर्थन प्रायोगिक है। Carthage के माध्यम से अपने ऐप में Firebase को शामिल करने के लिए GitHub पर निर्देश देखें।

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

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

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

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

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