আপনার Apple প্রোজেক্টে Firebase যোগ করা

পূর্বশর্ত

• এগুলি ইনস্টল করুন:

  • Xcode 26.2 বা তার পরবর্তী যেকোনও ভার্সন

• আপনার প্রোজেক্ট এইসব প্রয়োজনীয়তা পূরণ করছে কিনা তা ভালো করে দেখে নিন:

  • আপনার প্রোজেক্টকে অবশ্যই এইসব প্ল্যাটফর্ম ভার্সন বা তার পরের ভার্সনকে টার্গেট করতে হবে:
    • iOS 15
    • macOS 11
    • tvOS 15
    • watchOS 8

• আপনার অ্যাপ চালানোর জন্য কোনও ফিজিক্যাল Apple ডিভাইস সেট-আপ করুন বা সিমুলেটর ব্যবহার করুন।

  আপনি কি Cloud Messaging ব্যবহার করতে চান?

  Apple প্ল্যাটফর্মে Cloud Messaging-এর জন্য, এখানে পূর্বশর্তগুলি দেওয়া হল:

  • ফিজিক্যাল Apple ডিভাইস সেট-আপ করুন।
  • আপনার Apple ডেভেলপার অ্যাকাউন্টের জন্য Apple পুশ বিজ্ঞপ্তি প্রমাণীকরণ কী পান।
  • অ্যাপ > ক্যাপাবিলিটি বিকল্পের মধ্যে Xcode-এ পুশ বিজ্ঞপ্তি চালু করুন।

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

ধাপ ১: Firebase প্রোজেক্ট তৈরি করুন

আপনার Apple অ্যাপে Firebase যোগ করার আগে, অ্যাপের সাথে কানেক্ট করার জন্য আপনাকে Firebase প্রোজেক্ট তৈরি করতে হবে। Firebase প্রোজেক্ট সম্পর্কে আরও জানতে Firebase প্রোজেক্ট সম্পর্কে জানুন লিঙ্কে যান।

Firebase প্রোজেক্ট তৈরি করার নির্দেশাবলী দেখুন

Firebase বা Cloud-এ নতুন

আপনি Firebase বা Google Cloud-এ নতুন হলে, এইসব ধাপ অনুসরণ করুন।
এছাড়াও, আপনি যদি সম্পূর্ণ নতুন Firebase প্রোজেক্ট (এবং এর অন্তর্নিহিত Google Cloud প্রোজেক্ট) তৈরি করতে চান, তাহলে এইসব ধাপ অনুসরণ করতে পারেন।

1. Firebase কনসোলে সাইন-ইন করুন।
2. নতুন Firebase প্রোজেক্ট তৈরি করতে বোতামে ক্লিক করুন।

3. টেক্সট ফিল্ডে, প্রোজেক্টের নাম লিখুন।

   আপনি কোনও Google Cloud সংস্থার অংশ হলে, আপনি ঐচ্ছিকভাবে কোন ফোল্ডারে আপনার প্রোজেক্ট তৈরি করবেন তা বেছে নিতে পারবেন।

4. প্রম্পট করা হলে, Firebase-এর শর্তাবলী পর্যালোচনা করে সম্মতি জানান, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।
5. (ঐচ্ছিক) Firebase কনসোলে AI সহায়তা চালু করুন (এটি "Firebase-এ Gemini" নামে পরিচিত), যা আপনাকে শুরু করতে এবং আপনার ডেভেলপমেন্ট প্রসেসকে স্ট্রিমলাইন করতে সাহায্য করতে পারে।

6. (ঐচ্ছিক) আপনার প্রোজেক্টের জন্য Google Analytics সেট-আপ করুন, যা এইসব Firebase প্রোডাক্ট ব্যবহার করে অপ্টিমাল অভিজ্ঞতা প্রদান করে: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging এবং Remote Config (এর মধ্যে পছন্দমতো সাজিয়ে নেওয়া) পড়ে।

   আগে থেকে থাকা Google Analytics অ্যাকাউন্ট বেছে নিন অথবা নতুন অ্যাকাউন্ট তৈরি করুন। আপনি নতুন অ্যাকাউন্ট তৈরি করলে, আপনার Analytics রিপোর্টিং লোকেশন বেছে নিন, তারপর আপনার প্রোজেক্টের জন্য ডেটা শেয়ারিং সেটিংস ও Google Analytics শর্তাবলী সম্মতি দিন।

7. প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন।

Firebase আপনার প্রোজেক্ট তৈরি করে, কিছু প্রাথমিক রিসোর্স প্রদান করে এবং গুরুত্বপূর্ণ API চালু করে। প্রসেস সম্পূর্ণ হয়ে গেলে, আপনাকে Firebase কনসোলে Firebase প্রোজেক্টের ওভারভিউ পৃষ্ঠায় নিয়ে যাওয়া হবে।

আগে থেকে থাকা ক্লাউড প্রোজেক্ট

আগে থেকে থাকা Google Cloud প্রোজেক্টের সাথে Firebase ব্যবহার করা শুরু করতে চাইলে, এইসব ধাপ অনুসরণ করুন। আগে থেকে থাকা Google Cloudপ্রোজেক্টে "Firebase যোগ করা" সম্পর্কে আরও জানুন এবং সমস্যা সমাধান করুন।

1. যে অ্যাকাউন্ট দিয়ে আগে থেকেই Google Cloud প্রোজেক্ট অ্যাক্সেস করতে পারেন, সেই অ্যাকাউন্ট দিয়ে Firebase কনসোলে সাইন-ইন করুন।
2. নতুন Firebase প্রোজেক্ট তৈরি করতে বোতামে ক্লিক করুন।
3. পৃষ্ঠার নিচে, Google Cloud প্রোজেক্টে Firebase যোগ করুন বিকল্পে ক্লিক করুন।
4. টেক্সট ফিল্ডে, আগে থেকে থাকা প্রজেক্টের নাম লেখা শুরু করুন এবং তারপরে দেখানো তালিকা থেকে প্রজেক্টটি বেছে নিন।
5. প্রোজেক্ট খুলুন বিকল্পে ক্লিক করুন।
6. প্রম্পট করা হলে, Firebase-এর শর্তাবলী পর্যালোচনা করে সম্মতি জানান, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।
7. (ঐচ্ছিক) Firebase কনসোলে AI সহায়তা চালু করুন (এটি "Firebase-এ Gemini" নামে পরিচিত), যা আপনাকে শুরু করতে এবং আপনার ডেভেলপমেন্ট প্রসেসকে স্ট্রিমলাইন করতে সাহায্য করতে পারে।

8. (ঐচ্ছিক) আপনার প্রোজেক্টের জন্য Google Analytics সেট-আপ করুন, যা এইসব Firebase প্রোডাক্ট ব্যবহার করে অপ্টিমাল অভিজ্ঞতা প্রদান করে: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging এবং Remote Config (এর মধ্যে পছন্দমতো সাজিয়ে নেওয়া) পড়ে।

   আগে থেকে থাকা Google Analytics অ্যাকাউন্ট বেছে নিন অথবা নতুন অ্যাকাউন্ট তৈরি করুন। আপনি নতুন অ্যাকাউন্ট তৈরি করলে, আপনার Analytics রিপোর্টিং লোকেশন বেছে নিন, তারপর আপনার প্রোজেক্টের জন্য ডেটা শেয়ারিং সেটিংস ও Google Analytics শর্তাবলী সম্মতি দিন।

9. Firebase যোগ করুন বিকল্পে ক্লিক করুন।

Firebase আপনার আগে থেকে থাকা প্রোজেক্টে Firebase যোগ করে। প্রসেস সম্পূর্ণ হয়ে গেলে, আপনাকে Firebase কনসোলে আপনার Firebase প্রোজেক্টের ওভারভিউ পৃষ্ঠায় নিয়ে যাওয়া হবে।

ধাপ ২: Firebase-এ আপনার অ্যাপ রেজিস্টার করুন

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

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

2. সেট-আপ ওয়ার্কফ্লো লঞ্চ করতে, প্রোজেক্ট ওভারভিউ পৃষ্ঠার কেন্দ্রে, iOS+ আইকনে ক্লিক করুন ।

   আপনার Firebase প্রোজেক্টে কোনও অ্যাপ আগে থেকেই যোগ করে থাকলে, প্ল্যাটফর্ম বিকল্প দেখতে অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।

3. বান্ডেল আইডি ফিল্ডে আপনার অ্যাপের বান্ডেল আইডি লিখুন।

   বান্ডেল আইডি কী এবং এটি কোথায় পাওয়া যায়?

   • বান্ডেল আইডি Apple-এর ইকোসিস্টেমে কোনও অ্যাপ্লিকেশনকে অনন্যভাবে শনাক্ত করে।

   • আপনার বান্ডেল আইডি খুঁজুন: Xcode-এ আপনার প্রোজেক্ট খুলুন, প্রোজেক্ট নেভিগেটরে সবচেয়ে উপরের লেভেলের অ্যাপ বেছে নিন, তারপর সাধারণ ট্যাব বেছে নিন।

     বান্ডেল শনাক্তকারী ফিল্ডের ভ্যালু হল বান্ডেল আইডি (যেমন, com.yourcompany.yourproject)।

   • মনে রাখবেন, বান্ডেল আইডি ভ্যালু কেস-সেনসিটিভ এবং আপনার Firebase প্রোজেক্টে রেজিস্টার করার পরে এই Firebase অ্যাপের জন্য এটি পরিবর্তন করা যাবে না।

4. (ঐচ্ছিক) অন্যান্য অ্যাপের তথ্য লিখুন: অ্যাপের ডাকনাম ও App Store আইডি।

   Firebase-এর মধ্যে অ্যাপের ডাকনাম এবং App Store আইডি কীভাবে ব্যবহার করা হয়?

   • অ্যাপের ডাকনাম: ইন্টার্নাল, সুবিধাজনক শনাক্তকারী যা শুধুমাত্র Firebase কনসোলে আপনার কাছে দৃশ্যমান

   • App Store ID: Firebase Dynamic Links-এর মাধ্যমে ব্যবহারকারীদের আপনার App Store পৃষ্ঠায় রিডাইরেক্ট করা এবং Google Analytics-এর মাধ্যমে কনভার্সন ইভেন্ট ইমপোর্ট করার জন্য Google Ads ব্যবহার করা হয়। আপনার অ্যাপে এখনও App Store আইডি না থাকলে, আপনি পরে প্রোজেক্ট সেটিংসে আইডি যোগ করতে পারবেন।

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

ধাপ ৩: Firebase কনফিগারেশন ফাইল যোগ করুন

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

   এই কনফিগারেশন ফাইল সম্পর্কে আপনার কী জানা প্রয়োজন?

   • Firebase কনফিগারেশন ফাইলে আপনার প্রোজেক্ট ও অ্যাপের জন্য অনন্য, কিন্তু গোপনীয় নয় এমন শনাক্তকারী থাকে। এই কনফিগারেশন ফাইল সম্পর্কে আরও জানতে, Firebase প্রোজেক্ট সম্পর্কে জানুন লিঙ্কে যান।

   • আপনি যেকোনও সময় আবার Firebase কনফিগারেশন ফাইল ডাউনলোড করতে পারবেন।

   • কনফিগ ফাইলের নামের সাথে অতিরিক্ত অক্ষর যোগ করা হয়নি, যেমন (2), তা নিশ্চিত করুন।

2. আপনার Xcode প্রোজেক্টের রুটে config ফাইলটি সরান। প্রম্পট করা হলে, সব টার্গেটে কনফিগারেশন ফাইল যোগ করার বিকল্প বেছে নিন।

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

ধাপ ৪: আপনার অ্যাপে Firebase SDK যোগ করুন

Firebase ডিপেন্ডেন্সি ইনস্টল ও ম্যানেজ করতে Swift Package Manager ব্যবহার করুন।

1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলা থাকা অবস্থায়, ফাইল > প্যাকেজ যোগ করুন বিকল্পে নেভিগেট করুন।
2. প্রম্পট করা হলে, Firebase Apple প্ল্যাটফর্ম SDK রিপোজিটরি যোগ করুন:

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

3. আপনি যে SDK ভার্সন ব্যবহার করতে চান সেটি বেছে নিন।

4. আপনি যে Firebase লাইব্রেরি ব্যবহার করতে চান সেটি বেছে নিন।

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

এটি সম্পূর্ণ হয়ে গেলে, Xcode অটোমেটিক আপনার ডিপেন্ডেন্সি ব্যাকগ্রাউন্ডে সমাধান ও ডাউনলোড করা শুরু করবে।

ধাপ ৫: আপনার অ্যাপে Firebase ইনিশিয়ালাইজ করা

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

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

   SwiftUI

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

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. আপনার অ্যাপ ডেলিগেটের application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে FirebaseApp শেয়ার করা ইনস্ট্যান্স কনফিগার করুন:

   SwiftUI

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

   Swift

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

   Objective-C

   // 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 সফলভাবে ইনস্টল করেছেন।

এইটুকুই! আপনি পরবর্তী ধাপে যেতে পারেন।

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

উপলভ্য লাইব্রেরি

এই বিভাগে Apple প্ল্যাটফর্মে কাজ করে এমন Firebase প্রোডাক্টের তালিকা দেওয়া আছে। এইসব Firebase Apple প্ল্যাটফর্ম লাইব্রেরি সম্পর্কে আরও জানুন:

• রেফারেন্স ডকুমেন্টেশন (Swift | Obj-C)

• Firebase Apple প্ল্যাটফর্ম SDK GitHub রিপোজিটরি

পরিষেবা বা প্রোডাক্ট	লাইব্রেরি / ফ্রেমওয়ার্কের নাম	Analytics যোগ করবেন?
AdMob	GoogleMobileAds
Firebase AI Logic ১	FirebaseAILogic
Analytics	FirebaseAnalytics
App Check	FirebaseAppCheck
App Distribution	FirebaseAppDistribution
Authentication	FirebaseAuth
Cloud Firestore	FirebaseFirestore
Cloud Functions for Firebase Client SDK	FirebaseFunctions
Cloud Messaging	FirebaseMessaging
Cloud Storage	FirebaseStorage
Crashlytics	FirebaseCrashlytics
In-App Messaging	FirebaseInAppMessaging	(প্রয়োজনীয়)
Firebase ইনস্টলেশন	FirebaseInstallations
Performance Monitoring	FirebasePerformance
Realtime Database	FirebaseDatabase
Remote Config	FirebaseRemoteConfig
SQL Connect ২	FirebaseDataConnect
পুরনো বা কাজ করে না এমন লাইব্রেরি
Dynamic Links	FirebaseDynamicLinks
Firebase ML কাস্টম মডেল API	FirebaseMLModelDownloader

^{১ Firebase AI Logic (FirebaseAILogic) আগে "Firebase-এ Vertex AI" নামে পরিচিত ছিল এবং এটি FirebaseVertexAI মডিউলের অধীনে ডিস্ট্রিবিউট করা হত। Firebase AI Logic আগে FirebaseAI মডিউলের অধীনেও ডিস্ট্রিবিউট করা হত।}

^{২ Firebase SQL Connect-কে আগে "Firebase Data Connect" বলা হত।}

Swift Package Manager ব্যবহার না করে ইন্টিগ্রেট করা

আপনি Swift Package Manager ব্যবহার করতে না চাইলে, সরাসরি আগে থেকে কম্পাইল করা ফ্রেমওয়ার্ক ইমপোর্ট করেও Firebase ইন্টিগ্রেট করতে পারবেন।

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

iOS প্ল্যাটফর্মে কাজ করা ছাড়াও, জিপ ফাইলে এখন .xcframework ফাইল রয়েছে। বিস্তারিত জানতে, GitHub-এ Firebase Apple প্ল্যাটফর্ম SDK README দেখুন।

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

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

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

   • Firebase iOS SDK GitHub রিপোজিটরি-তে।
   • ডাউনলোড করা zip ডিস্ট্রিবিউশনের মধ্যে থাকা README.md ফাইলে।

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

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

পরবর্তী ধাপ

Firebase সম্পর্কে জানুন:

• Firebase প্রোজেক্ট ও প্রোজেক্টের জন্য পেশাদার পদ্ধতি সম্পর্কে আরও জানতে Firebase প্রোজেক্ট সম্পর্কে জানুন লিঙ্কে যান।

• Firebase অ্যাপের নমুনা এক্সপ্লোর করুন।

• Firebase iOS কোডল্যাব-এর মাধ্যমে হাতে-কলমে অভিজ্ঞতা পান।

• GitHub-এ ওপেন সোর্স কোড এক্সপ্লোর করুন।

• আপনার অ্যাপ লঞ্চ করার জন্য প্রস্তুত হন:

  • Google Cloud কনসোলে আপনার প্রোজেক্টের জন্য বাজেট অ্যালার্ট সেট-আপ করুন।
  • আপনার প্রজেক্টের একাধিক Firebase পরিষেবা জুড়ে ব্যবহারের একটি সামগ্রিক ছবি পেতে, Firebase কনসোলে ব্যবহার ও বিলিং ড্যাশবোর্ড মনিটর করুন।
  • Firebase লঞ্চ চেকলিস্ট পর্যালোচনা করুন।

• Firebase ও আপনার Apple প্রোজেক্ট নিয়ে সমস্যা হচ্ছে? Apple প্ল্যাটফর্মের সমস্যা সমাধান ও প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

আপনার অ্যাপে Firebase পরিষেবা যোগ করুন:

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

• Analytics-এর মাধ্যমে ব্যবহারকারীর আচরণ সম্পর্কে ইনসাইট পান।

• Authentication-এর মাধ্যমে ব্যবহারকারীর পরিচয় যাচাইকরণ সেট-আপ করুন।

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

• Cloud Storage-এর সাহায্যে ফটো ও ভিডিওর মতো ফাইল সেভ করুন।

• Cloud Functions-এর সাথে নিরাপদ পরিবেশে রান করে এমন ব্যাকএন্ড কোড ট্রিগার করুন।

• Cloud Messaging-এর মাধ্যমে বিজ্ঞপ্তি পাঠান।

• আপনার অ্যাপ কখন এবং কেন Crashlytics-এর মাধ্যমে ক্র্যাশ করছে তা খুঁজে বের করুন।