আপনার Apple প্রকল্পে Firebase যোগ করুন

পূর্বশর্ত

  • নিম্নলিখিতগুলি ইনস্টল করুন:

    • Xcode 16.2 বা তার পরবর্তী সংস্করণ

  • নিশ্চিত করুন যে আপনার প্রকল্পটি এই প্রয়োজনীয়তাগুলো পূরণ করে:

    • আপনার প্রজেক্টকে অবশ্যই এই প্ল্যাটফর্ম সংস্করণগুলো বা তার পরবর্তী সংস্করণগুলোকে টার্গেট করতে হবে:
      • আইওএস ১৫
      • ম্যাকওএস ১০.১৫
      • টিভিওএস ১৫
      • watchOS 7

  • আপনার অ্যাপটি চালানোর জন্য একটি বাস্তব অ্যাপল ডিভাইস সেট আপ করুন অথবা একটি সিমুলেটর ব্যবহার করুন।

যদি আপনার আগে থেকে কোনো Xcode প্রজেক্ট না থাকে এবং আপনি শুধু Firebase-এর কোনো প্রোডাক্ট ব্যবহার করে দেখতে চান, তাহলে আপনি আমাদের কুইকস্টার্ট স্যাম্পলগুলোর একটি ডাউনলোড করতে পারেন।

ধাপ ১ : একটি ফায়ারবেস প্রজেক্ট তৈরি করুন।

আপনার Apple অ্যাপে Firebase যোগ করার আগে, অ্যাপের সাথে সংযোগ করার জন্য আপনাকে একটি Firebase প্রজেক্ট তৈরি করতে হবে। Firebase প্রজেক্ট সম্পর্কে আরও জানতে “Understand Firebase Projects” অংশটি দেখুন।

ধাপ ২ : ফায়ারবেসে আপনার অ্যাপটি নিবন্ধন করুন।

আপনার Apple অ্যাপে Firebase ব্যবহার করতে হলে, আপনাকে আপনার Firebase প্রজেক্টের সাথে অ্যাপটি রেজিস্টার করতে হবে। অ্যাপ রেজিস্টার করাকে প্রায়শই প্রজেক্টে অ্যাপটি 'অ্যাড' করা বলা হয়।

  1. Firebase কনসোলে যান।

  2. প্রজেক্ট ওভারভিউ পেজের মাঝখানে থাকা iOS+ আইকনটিতে ক্লিক করে সেটআপ ওয়ার্কফ্লোটি চালু করুন।

    আপনি যদি আপনার Firebase প্রজেক্টে আগে থেকেই কোনো অ্যাপ যোগ করে থাকেন, তাহলে প্ল্যাটফর্ম অপশনগুলো দেখতে 'Add app'-এ ক্লিক করুন।

  3. বান্ডেল আইডি ফিল্ডে আপনার অ্যাপের বান্ডেল আইডিটি প্রবেশ করান।

  4. (ঐচ্ছিক) অ্যাপের অন্যান্য তথ্য দিন: অ্যাপের ডাকনাম এবং অ্যাপ স্টোর আইডি ।

  5. অ্যাপটি রেজিস্টার করতে ক্লিক করুন।

ধাপ ৩ : একটি ফায়ারবেস কনফিগারেশন ফাইল যোগ করুন

  1. আপনার অ্যাপের Firebase কনফিগারেশন ফাইল ( GoogleService-Info.plist ) পেতে Download GoogleService-Info.plist -এ ক্লিক করুন।

  2. আপনার কনফিগারেশন ফাইলটি আপনার Xcode প্রোজেক্টের রুটে সরান। যদি অনুরোধ করা হয়, তাহলে কনফিগারেশন ফাইলটি সমস্ত টার্গেটে যোগ করার জন্য নির্বাচন করুন।

আপনার প্রোজেক্টে একাধিক বান্ডেল আইডি থাকলে, আপনাকে অবশ্যই Firebase কনসোলে প্রতিটি বান্ডেল আইডিকে একটি নিবন্ধিত অ্যাপের সাথে যুক্ত করতে হবে, যাতে প্রতিটি অ্যাপের নিজস্ব GoogleService-Info.plist ফাইল থাকতে পারে।

ধাপ ৪ : আপনার অ্যাপে ফায়ারবেস এসডিকে যোগ করুন

ফায়ারবেস ডিপেন্ডেন্সিগুলো ইনস্টল ও পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

  1. Xcode-এ আপনার অ্যাপ প্রজেক্টটি খুলে, File > Add Packages- এ যান।
  2. অনুরোধ করা হলে, Firebase Apple প্ল্যাটফর্ম SDK রিপোজিটরিটি যোগ করুন: 
    3.   https://github.com/firebase/firebase-ios-sdk
  3. আপনি যে SDK সংস্করণটি ব্যবহার করতে চান, সেটি নির্বাচন করুন।

  4. আপনি যে ফায়ারবেস লাইব্রেরিগুলো ব্যবহার করতে চান, সেগুলো বেছে নিন।

    আপনার Firebase প্রজেক্টে যদি Google Analytics সক্রিয় করা থাকে, তাহলে FirebaseAnalytics যোগ করতে ভুলবেন না। এটি সমস্ত অ্যানালিটিক্স বৈশিষ্ট্য প্রদান করে। আপনি আলাদা আলাদা বৈশিষ্ট্যও নির্বাচন করতে পারেন; Google Analytics for Firebase SDK-তে মডিউলগুলির সর্বশেষ বিন্যাস সম্পর্কে জানতে আমাদের FAQ দেখুন।

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

ধাপ ৫ : আপনার অ্যাপে Firebase চালু করুন

চূড়ান্ত ধাপ হলো আপনার অ্যাপ্লিকেশনে ইনিশিয়ালাইজেশন কোড যোগ করা। আপনার অ্যাপে ফায়ারবেস যোগ করার অংশ হিসেবে আপনি হয়তো ইতিমধ্যেই এটি করে ফেলেছেন। আপনি যদি একটি কুইকস্টার্ট স্যাম্পল প্রজেক্ট ব্যবহার করেন, তবে এই কাজটি আপনার জন্য করা হয়ে গেছে।

  1. আপনার UIApplicationDelegate এ FirebaseCore মডিউলটি ইম্পোর্ট করুন, সেইসাথে আপনার অ্যাপ ডেলিগেট দ্বারা ব্যবহৃত অন্য যেকোনো Firebase মডিউলও ইম্পোর্ট করুন। উদাহরণস্বরূপ, Cloud Firestore এবং Authentication ব্যবহার করতে:

    SwiftUI 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    সুইফট 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    উদ্দেশ্য-সি 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. আপনার অ্যাপ ডেলিগেটের application(_:didFinishLaunchingWithOptions:) মেথডে একটি FirebaseApp শেয়ার্ড ইনস্ট্যান্স কনফিগার করুন:

    SwiftUI 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    সুইফট 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    উদ্দেশ্য-সি 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. আপনি যদি SwiftUI ব্যবহার করেন, তাহলে আপনাকে অবশ্যই একটি অ্যাপ্লিকেশন ডেলিগেট তৈরি করতে হবে এবং UIApplicationDelegateAdaptor বা NSApplicationDelegateAdaptor মাধ্যমে সেটিকে আপনার App struct-এর সাথে সংযুক্ত করতে হবে। আপনাকে অবশ্যই অ্যাপ ডেলিগেট সুইজলিং নিষ্ক্রিয় করতে হবে। আরও তথ্যের জন্য, SwiftUI নির্দেশাবলী দেখুন।

    SwiftUI 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. আপনি যদি Google Analytics এর জন্য Firebase SDK অন্তর্ভুক্ত করে থাকেন, তাহলে আপনি আপনার অ্যাপটি চালিয়ে Firebase কনসোলে একটি যাচাইকরণ বার্তা পাঠাতে পারেন, যা প্রমাণ করবে যে আপনি সফলভাবে Firebase ইনস্টল করেছেন।

ব্যাস! আপনি সরাসরি পরবর্তী ধাপে চলে যেতে পারেন।

তবে, সেট আপ করতে সমস্যা হলে, অ্যাপল প্ল্যাটফর্মের সমস্যা সমাধান ও প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQ) দেখুন।

উপলব্ধ লাইব্রেরি

এই বিভাগে অ্যাপল প্ল্যাটফর্মের জন্য সমর্থিত ফায়ারবেস পণ্যগুলির তালিকা দেওয়া হয়েছে। এই ফায়ারবেস অ্যাপল প্ল্যাটফর্ম লাইব্রেরিগুলি সম্পর্কে আরও জানুন:

পরিষেবা বা পণ্য শুঁটি সুইফটপিএম লাইব্রেরি অ্যানালিটিক্স যোগ করবেন?
AdMob pod 'Google-Mobile-Ads-SDK' প্রযোজ্য নয়
ফায়ারবেস এআই লজিক ১
 pod 'FirebaseAILogic' FirebaseAILogic
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Data Connect প্রযোজ্য নয় FirebaseDataConnect
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(প্রয়োজনীয়)
Firebase ইনস্টলেশন pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML কাস্টম মডেল এপিআই pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
অপ্রচলিত বা অসমর্থিত লাইব্রেরি
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks

Firebase AI Logic (FirebaseAILogic) -কে পূর্বে FirebaseAILogic Vertex AI in Firebase" বলা হতো এবং এটি FirebaseVertexAI মডিউলের অধীনে বিতরণ করা হতো। Firebase AI Logic পূর্বে FirebaseAI মডিউলের অধীনেও বিতরণ করা হতো।

সুইফট প্যাকেজ ম্যানেজার ব্যবহার না করে একীভূত করুন

আপনি যদি সুইফট প্যাকেজ ম্যানেজার ব্যবহার করতে না চান, তাহলেও কোকোয়া পডস (CocoaPods) ব্যবহার করে অথবা সরাসরি ফ্রেমওয়ার্কগুলো ইম্পোর্ট করে ফায়ারবেস এসডিকে (Firebase SDK)-গুলোর সুবিধা নিতে পারেন।

কোকোপড

আমাদের নির্দেশিকায় CocoaPods ইন্টিগ্রেশন সম্পর্কে আরও জানুন।

ফ্রেমওয়ার্ক

iOS প্ল্যাটফর্ম সমর্থন করার পাশাপাশি, জিপ ফাইলটিতে এখন .xcframework ফাইলও অন্তর্ভুক্ত করা হয়েছে। বিস্তারিত জানতে, গিটহাবে থাকা Firebase Apple platforms SDK README দেখুন।

  1. ফ্রেমওয়ার্ক SDK zip ফাইলটি ডাউনলোড করুন। এটি প্রায় ২০০ মেগাবাইটের একটি ফাইল এবং ডাউনলোড হতে কিছুটা সময় লাগতে পারে।

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

    আপনি নিম্নলিখিত স্থানগুলির যেকোনো একটিতে ইন্টিগ্রেশন নির্দেশাবলী খুঁজে পেতে পারেন:

    ফ্রেমওয়ার্ক সংস্করণ বা নির্ভরতা সংক্রান্ত তথ্যের জন্য, ডাউনলোড করা জিপ ডিস্ট্রিবিউশনের মধ্যে থাকা METADATA.md ফাইলটি দেখুন।

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

পরবর্তী পদক্ষেপ

ফায়ারবেস সম্পর্কে জানুন:

আপনার অ্যাপে ফায়ারবেস পরিষেবাগুলি যোগ করুন:

  • Firebase AI Logic ব্যবহার করে Gemini এবং Imagen মডেলের সাহায্যে জেনারেটিভ এআই ফিচার তৈরি করুন।

  • Analytics এর মাধ্যমে ব্যবহারকারীর আচরণ সম্পর্কে ধারণা লাভ করুন।

  • Authentication ব্যবহার করে ব্যবহারকারীর প্রমাণীকরণ সেট আপ করুন।

  • ব্যবহারকারীর তথ্যের মতো ডেটা Cloud Firestore বা Realtime Database এ সংরক্ষণ করুন।

  • Cloud Storage ফটো এবং ভিডিওর মতো ফাইল সংরক্ষণ করুন।

  • Cloud Functions ব্যবহার করে একটি সুরক্ষিত পরিবেশে চালিত ব্যাকএন্ড কোড চালু করুন।

  • Cloud Messaging এর মাধ্যমে নোটিফিকেশন পাঠান।

  • Crashlytics এর মাধ্যমে জেনে নিন আপনার অ্যাপটি কখন এবং কেন ক্র্যাশ করছে।