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

Swift প্যাকেজ ম্যানেজার

Firebase নতুন প্রোজেক্টের জন্য Swift প্যাকেজ ম্যানেজার সাজেস্ট করে।

Xcode-এর মাধ্যমে

Swift প্যাকেজ ম্যানেজার ব্যবহার করতে হলে 26.2 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

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

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

3. যে প্রম্পট দেখানো হবে, সেখান থেকে Firebase GitHub রিপোজিটরি বেছে নিন:

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

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

5. আপনার অ্যাপে যে Firebase লাইব্রেরি যোগ করতে চান সেটি বেছে নিন।

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

Package.swift হয়ে

Package.swift ম্যানিফেস্টের মাধ্যমে Swift প্যাকেজে Firebase ইন্টিগ্রেট করতে, আপনি আপনার প্যাকেজের dependencies অ্যারেতে Firebase যোগ করতে পারেন। আরও জানতে, Swift প্যাকেজ ম্যানেজার ডকুমেন্টেশন দেখুন।

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

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

সতর্কতা: CocoaPods ঘোষণা করেছে যে ২০২৬ সালের ডিসেম্বর থেকে এটি শুধুমাত্র পড়ার জন্য উপলভ্য হবে, যার পরে নতুন পড ভার্সন আর প্রকাশ করা যাবে না। এই কারণে, Firebase ২০২৬ সালের অক্টোবর থেকে CocoaPods-এ নতুন ভার্সন প্রকাশ করা বন্ধ করে দেবে। আরও জানতে, CocoaPods থেকে মাইগ্রেট করুন দেখুন।

Swift Package Manager ছাড়াও Firebase-এ CocoaPods ব্যবহার করে ইনস্টল করা যায়।

Firebase-এর CocoaPods ডিস্ট্রিবিউশনের জন্য Xcode 26.2 এবং CocoaPods 1.12.0 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন। CocoaPods ব্যবহার করে কীভাবে Firebase ইনস্টল করবেন তা এখানে দেওয়া হল:

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

   pod init

   মনে রাখবেন: Podfiles-এ অবশ্যই use_frameworks! (ডায়নামিক লিঙ্কিং) বা use_frameworks! :linkage => :static থাকতে হবে; আরও বিবরণের জন্য Firebase ডিপেন্ডেন্সি স্ট্যাটিক বা ডায়নামিক উপায়ে লিঙ্ক করা সম্পর্কিত ডকুমেন্টেশন দেখুন।

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

   আপনি নিজের অ্যাপে কাজ করে এমন 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'

   Apple-এর ব্যবহারকারীর গোপনীয়তা ও ডেটার ব্যবহার এবং অ্যাপ ট্র্যাকিং ট্রান্সপারেন্সি ডকুমেন্টেশন থেকে ডিভাইস-লেভেল বিজ্ঞাপন শনাক্তকারী IDFA সম্পর্কে আরও জানুন।

   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'

   বাইনারি Firebase ডিপেন্ডেন্সি ডিফল্ট হিসেবে স্ট্যাটিক ফ্রেমওয়ার্ক হিসেবে ইন্টিগ্রেট করা হয়। আপনি যদি ডায়নামিক ফ্রেমওয়ার্কের ডিপেন্ডেন্সি হিসেবে Firebase ব্যবহার করেন, তাহলে ফ্রেমওয়ার্ক বা লাইব্রেরি থেকে Firebase ব্যবহার করা সম্পর্কিত ডকুমেন্টেশন পড়েছেন কিনা তা নিশ্চিত করুন।

3. পড ইনস্টল করুন, তারপর Xcode-এ প্রোজেক্ট দেখতে আপনার .xcworkspace ফাইল খুলুন:

   pod install --repo-update

   open your-project.xcworkspace

প্রোডাক্ট-নির্দিষ্ট বিবেচনা

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

কার্থেজ

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

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

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

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

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

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