আপনার Apple অ্যাপে Firebase ইনস্টল করুন

সুইফট প্যাকেজ ম্যানেজার

Firebase নতুন প্রকল্পের জন্য সুইফট প্যাকেজ ম্যানেজার সুপারিশ করে।

এক্সকোডের মাধ্যমে

সুইফ্ট প্যাকেজ ম্যানেজার সমর্থনের জন্য 14.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. Firebase-এর যে সংস্করণটি আপনি ব্যবহার করতে চান সেটি নির্বাচন করুন। নতুন প্রকল্পের জন্য, আমরা Firebase-এর নতুন সংস্করণ ব্যবহার করার পরামর্শ দিই।

  5. আপনি আপনার অ্যাপে অন্তর্ভুক্ত করতে চান এমন Firebase লাইব্রেরিগুলি বেছে নিন।

একবার আপনি শেষ হয়ে গেলে, এক্সকোড আপনার প্যাকেজ নির্ভরতাগুলি সমাধান করা এবং পটভূমিতে সেগুলি ডাউনলোড করা শুরু করবে।

Package.swift এর মাধ্যমে

একটি Package.swift ম্যানিফেস্টের মাধ্যমে Firebase-কে সুইফট প্যাকেজে সংহত করতে, আপনি আপনার প্যাকেজের 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-এর জন্য আপনাকে ডিবাগ চিহ্ন আপলোড করতে হবে।

বিল্ড-পরবর্তী ডিবাগ চিহ্নগুলি স্বয়ংক্রিয়ভাবে আপলোড করতে আপনি 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 এর CocoaPods বিতরণের জন্য Xcode 14.1 এবং CocoaPods 1.12.0 বা উচ্চতর প্রয়োজন। কোকোপডস ব্যবহার করে ফায়ারবেস কীভাবে ইনস্টল করবেন তা এখানে:

  1. আপনার যদি ইতিমধ্যে একটি না থাকে তবে একটি পডফাইল তৈরি করুন। আপনার প্রকল্প ডিরেক্টরির রুট থেকে, নিম্নলিখিত কমান্ডটি চালান:

    pod init
  2. আপনার পডফাইলে, ফায়ারবেস পডগুলি যোগ করুন যা আপনি আপনার অ্যাপে ব্যবহার করতে চান।

    আপনি আপনার অ্যাপে যেকোনও সমর্থিত Firebase পণ্য যোগ করতে পারেন।

    বিশ্লেষণ সক্রিয় করা হয়েছে

    # 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-এর জন্য আপনাকে ডিবাগ চিহ্ন আপলোড করতে হবে।

বিল্ড-পরবর্তী ডিবাগ চিহ্নগুলি স্বয়ংক্রিয়ভাবে আপলোড করতে আপনি Xcode-এর জন্য একটি রান স্ক্রিপ্ট বিল্ড ফেজ ব্যবহার করতে পারেন। রান স্ক্রিপ্ট এখানে খুঁজুন:

"${PODS_ROOT}/FirebaseCrashlytics/run"

কার্থেজ

কার্থেজ সমর্থন পরীক্ষামূলক। Carthage এর মাধ্যমে আপনার অ্যাপে Firebase অন্তর্ভুক্ত করার জন্য GitHub-এর নির্দেশাবলী দেখুন।

ম্যানুয়ালি ইন্টিগ্রেট করুন

Firebase ব্যবহারকারীদের জন্য একটি পূর্ব-নির্মিত বাইনারি XCFramework বিতরণ প্রদান করে যারা নির্ভরতা ম্যানেজার ব্যবহার না করে Firebase সংহত করতে চান। Firebase ইনস্টল করতে:

  1. ফ্রেমওয়ার্ক SDK জিপ ডাউনলোড করুন। এই ফাইলটিতে সমস্ত Firebase SDK-এর জন্য উপলব্ধ সমস্ত লক্ষ্য আর্কিটেকচারের জন্য আর্কিটেকচার স্লাইস রয়েছে এবং এইভাবে ডাউনলোড হতে কিছু সময় লাগতে পারে৷

  2. ফাইলটি আনজিপ করুন, তারপরে আপনি আপনার অ্যাপে যে ফ্রেমওয়ার্কগুলি অন্তর্ভুক্ত করতে চান তার জন্য README পর্যালোচনা করুন৷

  3. আপনার লক্ষ্যের বিল্ড সেটিংসে আপনার Other Linker Settings -ObjC লিঙ্কার পতাকা যোগ করুন।