আপনার অ্যাপল অ্যাপে ফায়ারবেস ইনস্টল করার বিকল্পগুলি

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

নতুন প্রোজেক্টের জন্য ফায়ারবেস সুইফট প্যাকেজ ম্যানেজার ব্যবহারের পরামর্শ দেয়।

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

সুইফট প্যাকেজ ম্যানেজার সাপোর্টের জন্য ১৬.২ বা উচ্চতর সংস্করণ প্রয়োজন।

  1. যদি কোনো CocoaPods-ভিত্তিক প্রজেক্ট থেকে মাইগ্রেট করেন, তাহলে আপনার Xcode প্রজেক্ট থেকে CocoaPods সরিয়ে ফেলার জন্য pod deintegrate চালান। এরপর CocoaPods দ্বারা তৈরি ` .xcworkspace ফাইলটি নিরাপদে ডিলিট করে দেওয়া যেতে পারে। যদি আপনি প্রথমবারের মতো কোনো প্রজেক্টে Firebase যোগ করেন, তাহলে এই ধাপটি উপেক্ষা করা যেতে পারে।

  2. Xcode-এ, File > Add Packages- এ গিয়ে Firebase লাইব্রেরিগুলো ইনস্টল করুন।

  3. প্রদর্শিত প্রম্পটে, ফায়ারবেস গিটহাব রিপোজিটরিটি নির্বাচন করুন:

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

  4. আপনি Firebase-এর যে সংস্করণটি ব্যবহার করতে চান তা নির্বাচন করুন। নতুন প্রোজেক্টের জন্য, আমরা Firebase-এর সর্বাধুনিক সংস্করণটি ব্যবহার করার পরামর্শ দিই।

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

পণ্য-নির্দিষ্ট বিবেচ্য বিষয়

কিছু 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-এর CocoaPods ডিস্ট্রিবিউশনের জন্য Xcode 16.2 এবং CocoaPods 1.12.0 বা তার উচ্চতর সংস্করণ প্রয়োজন। CocoaPods ব্যবহার করে Firebase ইনস্টল করার পদ্ধতি নিচে দেওয়া হলো:

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

    pod init

  2. আপনার Podfile-এ সেই Firebase পডগুলো যোগ করুন যেগুলো আপনি আপনার অ্যাপে ব্যবহার করতে চান।

    আপনি আপনার অ্যাপে যেকোনো সমর্থিত ফায়ারবেস পণ্য যোগ করতে পারেন।

    Analytics সক্রিয় করা হয়েছে 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# 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-এর ব্যবহারকারীর গোপনীয়তা ও ডেটা ব্যবহার এবং অ্যাপ ট্র্যাকিং স্বচ্ছতা সংক্রান্ত ডকুমেন্টেশন পড়ুন।

    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. পডগুলো ইনস্টল করুন, তারপর এক্সকোডে প্রজেক্টটি দেখতে আপনার .xcworkspace ফাইলটি খুলুন:

    pod install --repo-update
    open your-project.xcworkspace

পণ্য-নির্দিষ্ট বিবেচ্য বিষয়

কিছু Firebase প্রোডাক্ট সঠিকভাবে কাজ করার জন্য অতিরিক্ত ইন্টিগ্রেশন ধাপের প্রয়োজন হয়।

Crashlytics

Crashlytics ব্যবহারের জন্য আপনাকে ডিবাগ সিম্বল আপলোড করতে হবে।

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

কার্থেজ

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

ম্যানুয়ালি একীভূত করুন

যেসব ব্যবহারকারী কোনো ডিপেন্ডেন্সি ম্যানেজার ব্যবহার না করে ফায়ারবেস ইন্টিগ্রেট করতে চান, তাদের জন্য ফায়ারবেস একটি প্রি-বিল্ট বাইনারি XCFramework ডিস্ট্রিবিউশন প্রদান করে। ফায়ারবেস ইনস্টল করতে:

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

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

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