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

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

फायरबेस नई परियोजनाओं के लिए स्विफ्ट पैकेज मैनेजर की सिफारिश करता है।

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

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

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

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

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

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. फायरबेस का वह संस्करण चुनें जिसका आप उपयोग करना चाहते हैं। नई परियोजनाओं के लिए, हम फायरबेस के नवीनतम संस्करण का उपयोग करने की सलाह देते हैं।

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

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

Package.swift के माध्यम से

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

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"),
    // ...
  ]
),

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

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

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

यदि परिवर्तनीय रूप से शामिल किया गया है तो Google Analytics को आपके लक्ष्य की बिल्ड सेटिंग्स में -ObjC लिंकर फ़्लैग जोड़ने की आवश्यकता होती है।

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

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

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

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

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

chmod +x scripts/upload-symbols

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

कोकोपोड्स

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

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

  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'

    ऐप्पल के उपयोगकर्ता गोपनीयता और डेटा उपयोग और ऐप ट्रैकिंग पारदर्शिता दस्तावेज़ में डिवाइस-स्तरीय विज्ञापन पहचानकर्ता आईडीएफए के बारे में और जानें।

    एनालिटिक्स सक्षम नहीं है

    # 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

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

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

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

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

कार्थेज

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

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

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

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

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

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