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

আমাদের Firebase C++ SDK-এর মাধ্যমে আপনার C++ গেমকে আরও শক্তিশালী করে তুলুন যা Firebase SDK-এর উপরে C++ ইন্টারফেস প্রদান করে।

কোনও প্ল্যাটফর্ম-নেটিভ কোড না লিখেই, আপনার C++ কোড থেকে সম্পূর্ণভাবে Firebase অ্যাক্সেস করুন। এছাড়াও, Firebase SDK, Firebase-এর ব্যবহার করা অনেক ভাষা-নির্দিষ্ট ইডিয়মকে C++ ডেভেলপারদের কাছে আরও পরিচিত ইন্টারফেসে অনুবাদ করে।

Firebase-এর মাধ্যমে আপনার গেমকে আরও শক্তিশালী করার ব্যাপারে আরও তথ্য জানতে আমাদের Firebase গেম পৃষ্ঠা দেখুন।

আপনার C++ প্রোজেক্টে Firebase আগে থেকেই যোগ করা আছে? আপনি Firebase C++ SDK-এর লেটেস্ট ভার্সন ব্যবহার করছেন কিনা তা নিশ্চিত করুন।


পূর্বশর্ত

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

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

  • আপনার প্রোজেক্ট যাতে নিম্নলিখিত প্ল্যাটফর্ম ভার্সন বা তার পরবর্তী ভার্সনকে টার্গেট করে তা নিশ্চিত করুন:

    • iOS 15
    • tvOS 15

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

  • আপনার Google অ্যাকাউন্ট ব্যবহার করে Firebase-এ সাইন-ইন করুন।

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

আপনার C++ প্রোজেক্টে Firebase যোগ করার আগে, আপনার C++ প্রোজেক্টের সাথে কানেক্ট করার জন্য আপনাকে একটি Firebase প্রোজেক্ট তৈরি করতে হবে। Firebase প্রোজেক্ট সম্পর্কে আরও জানতে Firebase প্রোজেক্ট বুঝুন পৃষ্ঠা দেখুন।

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

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

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

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

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

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

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

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

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

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

  2. IDE-তে আপনার C++ প্রোজেক্ট খুলুন, তারপর আপনার কনফিগারেশন ফাইলটি আপনার C++ প্রোজেক্টের রুটে টেনে আনুন।

  3. প্রম্পট করা হলে, সব টার্গেটে কনফিগারেশন ফাইল যোগ করার বিকল্প বেছে নিন।

Firebase কনসোলে সেট-আপ সংক্রান্ত টাস্ক আপনি সম্পূর্ণ করেছেন। নিচে Firebase C++ SDK যোগ করুন বিকল্পে গিয়ে চালিয়ে যান।

ধাপ ৫: Firebase C++ SDK যোগ করুন

এই বিভাগে উল্লেখ করা ধাপগুলি হল আপনার Firebase C++ প্রোজেক্টে কাজ করে এমন Firebase প্রোডাক্ট কীভাবে যোগ করবেন তার উদাহরণ।

  1. Firebase C++ SDK ডাউনলোড করুন, তারপর সুবিধাজনক কোনও জায়গায় SDK আনজিপ করুন।

    Firebase C++ SDK প্ল্যাটফর্ম-নির্দিষ্ট নয়, তবে এতে প্ল্যাটফর্ম-নির্দিষ্ট লাইব্রেরি রয়েছে।

  2. আনজিপ করা SDK থেকে Firebase পড যোগ করুন।

    1. আপনার কাছে আগে থেকে Podfile না থাকলে, একটি তৈরি করুন: 

      cd your-app-directory
       
      pod init

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

      Analytics চালু করা রয়েছে 

      # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'
      
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

      Analytics চালু করা নেই 

      # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

    3. পড ইনস্টল করুন, তারপর Xcode-এ .xcworkspace ফাইল খুলুন। 

      pod install
       
      open your-app.xcworkspace

  3. আনজিপ করা SDK থেকে Firebase ফ্রেমওয়ার্ক যোগ করুন।

    এই ফ্রেমওয়ার্ক যোগ করার সবচেয়ে সহজ উপায় হল, সাধারণত Finder উইন্ডো থেকে সরাসরি Xcode-এর প্রোজেক্ট নেভিগেটর প্যানে (ডিফল্ট হিসেবে, একদম বাঁদিকের প্যান; অথবা Xcode-এর উপরে বাঁদিকে ফাইল আইকনে ক্লিক করুন) টেনে এনে ড্রপ করা।

    1. Firebase C++ ফ্রেমওয়ার্ক firebase.framework যোগ করুন, যা যেকোনও Firebase প্রোডাক্ট ব্যবহার করার জন্য প্রয়োজন।

    2. আপনি ব্যবহার করতে চান এমন প্রতিটি Firebase প্রোডাক্টের জন্য ফ্রেমওয়ার্ক যোগ করুন। যেমন, Firebase Authentication ব্যবহার করতে, firebase_auth.framework যোগ করুন।

  4. Firebase কনসোলে ফিরে গিয়ে, সেট-আপ ওয়ার্কফ্লোতে, পরবর্তী বিকল্পে ক্লিক করুন।

  5. আপনি Analytics যোগ করে থাকলে, Firebase-এ যাচাইকরণ পাঠাতে আপনার অ্যাপ চালান যাতে বোঝা যায় যে আপনি Firebase সফলভাবে ইন্টিগ্রেট করেছেন। অন্যথায়, আপনি এই যাচাইকরণ ধাপ এড়িয়ে যেতে পারেন।

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

আপনি একদম রেডি! আপনার C++ অ্যাপ রেজিস্টার করা হয়েছে এবং Firebase প্রোডাক্ট ব্যবহার করার জন্য কনফিগার করা হয়েছে।

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

রেফারেন্স ডকুমেন্টেশন এবং GitHub-এ আমাদের ওপেন-সোর্স SDK রিলিজ থেকে C++ Firebase লাইব্রেরি সম্পর্কে আরও জানুন।

Apple প্ল্যাটফর্মের জন্য উপলভ্য লাইব্রেরি

মনে রাখবেন যে Android-এর জন্য C++ লাইব্রেরি এই সেট-আপ পৃষ্ঠার Android ভার্সনে তালিকাভুক্ত করা আছে।

প্রতিটি Firebase প্রোডাক্টের আলাদা আলাদা ডিপেন্ডেন্সি আছে। আপনার Podfile এবং C++ প্রোজেক্টে কাঙ্ক্ষিত Firebase প্রোডাক্টের জন্য তালিকাভুক্ত সব ডিপেন্ডেন্সি যোগ করতে ভুলবেন না।

প্রতিটি Firebase প্রোডাক্ট শুধুমাত্র Apple OS প্ল্যাটফর্মের (iOS, tvOS ইত্যাদি) একটি বাছাই করা অংশকে সাপোর্ট করতে পারে। C++ এবং Firebase সম্পর্কে আরও জানুন লিঙ্কে গিয়ে প্রতিটি লাইব্রেরি কোন কোন প্ল্যাটফর্মে কাজ করে তা চেক করুন।

Firebase প্রোডাক্ট ফ্রেমওয়ার্ক ও পড
Analytics (প্রয়োজনীয়) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '13.0.0'
App Check (প্রয়োজনীয়) firebase.framework
firebase_app_check.framework

pod 'FirebaseAppCheck', '13.0.0'
Authentication (প্রয়োজনীয়) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '13.0.0'
Cloud Firestore (প্রয়োজনীয়) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '13.0.0'
pod 'FirebaseAuth', '13.0.0'
Cloud Functions (প্রয়োজনীয়) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '13.0.0'
Cloud Messaging (প্রয়োজনীয়) firebase.framework
firebase_messaging.framework
(সাজেস্ট করা হয়েছে) firebase_analytics.framework

pod 'FirebaseMessaging', '13.0.0'
(সাজেস্ট করা হয়েছে) pod 'FirebaseAnalytics', '13.0.0'
Cloud Storage (প্রয়োজনীয়) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '13.0.0'
Realtime Database (প্রয়োজনীয়) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '13.0.0'
Remote Config (প্রয়োজনীয়) firebase.framework
firebase_remote_config.framework
(সাজেস্ট করা হয়েছে) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '13.0.0'
(সাজেস্ট করা হয়েছে) pod 'FirebaseAnalytics', '13.0.0'
বাতিল করা বা কাজ করে না এমন লাইব্রেরি
Dynamic Links (প্রয়োজনীয়) firebase.framework
firebase_dynamic_links.framework
(সাজেস্ট করা হয়েছে) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '13.0.0'
(সাজেস্ট করা হয়েছে) pod 'FirebaseAnalytics', '13.0.0'

মোবাইল সেট-আপের জন্য অতিরিক্ত তথ্য

মেথড সুইজলিং

iOS-এ, কিছু অ্যাপ্লিকেশন ইভেন্টের (যেমন URL খোলা এবং বিজ্ঞপ্তি পাওয়া) জন্য আপনার অ্যাপ্লিকেশন ডেলিগেটকে নির্দিষ্ট পদ্ধতি প্রয়োগ করতে হবে। যেমন, বিজ্ঞপ্তি পেতে হলে আপনার অ্যাপ্লিকেশন ডেলিগেটকে application:didReceiveRemoteNotification: প্রয়োগ করতে হতে পারে। প্রতিটি iOS অ্যাপ্লিকেশনের নিজস্ব অ্যাপ ডেলিগেট থাকে, তাই Firebase মেথড সুইজলিং ব্যবহার করে, যা একটি মেথডের পরিবর্তে অন্য একটি মেথড ব্যবহার করার অনুমতি দেয়, যাতে আপনি হয়ত প্রয়োগ করেছেন এমন যেকোনও হ্যান্ডলার ছাড়াও নিজস্ব হ্যান্ডলার অ্যাটাচ করা যায়।

Dynamic Links এবং Cloud Messaging লাইব্রেরিকে মেথড সুইজলিং ব্যবহার করে অ্যাপ্লিকেশন ডেলিগেটে হ্যান্ডলার অ্যাটাচ করতে হবে। আপনি এইসব Firebase প্রোডাক্টের মধ্যে কোনও একটি ব্যবহার করলে, লোড করার সময়, Firebase আপনার AppDelegate ক্লাস শনাক্ত করবে এবং প্রয়োজনীয় পদ্ধতি এতে সুইজেল করবে, আপনার বর্তমান পদ্ধতি প্রয়োগে কল ব্যাক চেইন করবে।

ডেস্কটপ ওয়ার্কফ্লো সেট-আপ করা (বিটা)

আপনি কোনও গেম তৈরি করার সময়, প্রথমে ডেস্কটপ প্ল্যাটফর্মে আপনার গেম পরীক্ষা করা এবং পরে ডেভেলপমেন্টের সময় মোবাইল ডিভাইসে ডেপ্লয় ও পরীক্ষা করা অনেক সহজ। এই ওয়ার্কফ্লোতে সহায়তা করতে, আমরা Firebase C++ SDK-এর সাবসেট প্রদান করি যা Windows, macOS, Linux এবং C++ এডিটরের মধ্যে থেকে রান করতে পারে।

  1. ডেস্কটপ ওয়ার্কফ্লোর জন্য, আপনাকে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে হবে:

    1. CMake-এর জন্য আপনার C++ প্রোজেক্ট কনফিগার করুন।
    2. Firebase প্রোজেক্ট তৈরি করুন
    3. Firebase-এ আপনার অ্যাপ (iOS বা Android) রেজিস্টার করুন
    4. মোবাইল-প্ল্যাটফর্ম Firebase কনফিগারেশন ফাইল যোগ করা

  2. Firebase কনফিগারেশন ফাইলের একটি ডেস্কটপ ভার্সন তৈরি করুন:

    • আপনি Android google-services.json ফাইল যোগ করলে — আপনার অ্যাপ রান করার সময়, Firebase এই মোবাইল ফাইলটি খুঁজে নেয়, তারপর অটোমেটিক একটি ডেস্কটপ Firebase কনফিগারেশন ফাইল (google-services-desktop.json) তৈরি করে।

    • আপনি iOS GoogleService-Info.plist ফাইল যোগ করে থাকলে — আপনার অ্যাপ চালানোর আগে, আপনাকে এই মোবাইল ফাইলটি একটি ডেস্কটপ Firebase কনফিগারেশন ফাইলে কনভার্ট করতে হবে। ফাইলটি কনভার্ট করতে, আপনার GoogleService-Info.plist ফাইলের মতো একই ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি রান করান:

      generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist

    এই ডেস্কটপ কনফিগারেশন ফাইলে C++ প্রোজেক্ট আইডি থাকে যা আপনি Firebase কনসোল সেট-আপ ওয়ার্কফ্লোতে লিখেছেন। কনফিগারেশন ফাইল সম্পর্কে আরও জানতে Firebase প্রোজেক্ট বুঝুন লিঙ্কে যান।

  3. আপনার C++ প্রোজেক্টে Firebase SDK যোগ করুন।

    নিচে উল্লেখ করা ধাপগুলি থেকে আপনি জানতে পারবেন যে কীভাবে আপনার C++ প্রোজেক্টে কাজ করে এমন Firebase প্রোডাক্ট যোগ করবেন। এই উদাহরণে, আমরা Firebase Authentication এবং Firebase Realtime Database যোগ করার ধাপগুলি দেখব।

    1. আপনার FIREBASE_CPP_SDK_DIR এনভায়রনমেন্ট ভেরিয়েবলকে আনজিপ করা Firebase C++ SDK-এর লোকেশনে সেট করুন।

    2. আপনার প্রোজেক্টের CMakeLists.txt ফাইলে, নিম্নলিখিত কন্টেন্ট যোগ করুন, যার মধ্যে আপনি যে Firebase প্রোডাক্ট ব্যবহার করতে চান তার জন্য লাইব্রেরি অন্তর্ভুক্ত করুন। যেমন, Firebase Authentication এবং Firebase Realtime Database ব্যবহার করতে:

      # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

# Add the Firebase SDKs for the products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
set(firebase_libs firebase_auth firebase_database firebase_app)
target_link_libraries(${target_name} "${firebase_libs}")

  4. আপনার C++ অ্যাপ রান করুন।

উপলভ্য লাইব্রেরি (ডেস্কটপ)

Firebase C++ SDK-তে ফিচার সাবসেটের জন্য ডেস্কটপ ওয়ার্কফ্লো সহায়তা অন্তর্ভুক্ত আছে, যা Windows, macOS ও Linux-এ স্ট্যান্ডঅ্যালোন ডেস্কটপ বিল্ডে Firebase-এর নির্দিষ্ট কিছু অংশ ব্যবহার করার সুবিধা দেয়।

Firebase প্রোডাক্ট লাইব্রেরি রেফারেন্স (CMake ব্যবহার করে)
App Check firebase_app_check
(প্রয়োজনীয়) firebase_app
Authentication firebase_auth
(প্রয়োজনীয়) firebase_app
Cloud Firestore firebase_firestore
firebase_auth
firebase_app
Cloud Functions firebase_functions
(প্রয়োজনীয়) firebase_app
Cloud Storage firebase_storage
(প্রয়োজনীয়) firebase_app
Realtime Database firebase_database
(প্রয়োজনীয়) firebase_app
Remote Config firebase_remote_config
(প্রয়োজনীয়) firebase_app

Firebase, Windows, macOS এবং Linux-এর জন্য তৈরি করার সময় সুবিধার জন্য স্টাব (নন-ফাংশনাল) বাস্তবায়ন হিসাবে বাকি ডেস্কটপ লাইব্রেরিগুলি প্রদান করে। তাই, ডেস্কটপকে টার্গেট করার জন্য আপনাকে শর্তসাপেক্ষে কোড কম্পাইল করতে হবে না।

Realtime Database ডেস্কটপ

ডেস্কটপের জন্য Realtime Database SDK আপনার ডেটাবেস অ্যাক্সেস করতে REST ব্যবহার করে, তাই আপনাকে অবশ্যই ইনডেক্স ঘোষণা করতে হবে যা আপনি ডেস্কটপে Query::OrderByChild() এর সাথে ব্যবহার করেন বা আপনার শ্রোতারা ব্যর্থ হবে।

ডেস্কটপ সেট-আপের জন্য অতিরিক্ত তথ্য

Windows লাইব্রেরি

Windows-এর জন্য, নিম্নলিখিত বিষয়ের উপর ভিত্তি করে লাইব্রেরি ভার্সন প্রদান করা হয়:

  • বিল্ড প্ল্যাটফর্ম: 32-বিট (x86) বনাম 64-বিট (x64) মোড
  • Windows রানটাইম এনভায়রনমেন্ট: মাল্টিথ্রেডেড / MT বনাম মাল্টিথ্রেডেড DLL /MD
  • টার্গেট: রিলিজ বনাম ডিবাগ

মনে রাখবেন যে নিম্নলিখিত লাইব্রেরিগুলি Visual Studio 2015 এবং 2017 ব্যবহার করে পরীক্ষা করা হয়েছে।

Windows-এ C++ ডেস্কটপ অ্যাপ তৈরি করার সময়, আপনার প্রোজেক্টে নিম্নলিখিত Windows SDK লাইব্রেরি লিঙ্ক করুন। আরও তথ্যের জন্য আপনার কম্পাইলার ডকুমেন্টেশন দেখুন।

Firebase C++ লাইব্রেরি Windows SDK লাইব্রেরি ডিপেন্ডেন্সি
App Check advapi32, ws2_32, crypt32
Authentication advapi32, ws2_32, crypt32
Cloud Firestore advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32
Cloud Functions advapi32, ws2_32, crypt32, rpcrt4, ole32
Cloud Storage advapi32, ws2_32, crypt32
Realtime Database advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv
Remote Config advapi32, ws2_32, crypt32, rpcrt4, ole32

macOS লাইব্রেরি

macOS (Darwin)-এর জন্য, ৬৪-বিট (x86_64) প্ল্যাটফর্মে লাইব্রেরি ভার্সন প্রদান করা হয়। আপনার সুবিধার জন্য ফ্রেমওয়ার্কও প্রদান করা হয়।

মনে রাখবেন যে macOS লাইব্রেরি Xcode 26.2 ব্যবহার করে পরীক্ষা করা হয়েছে।

macOS-এ C++ ডেস্কটপ অ্যাপ তৈরি করার সময়, আপনার প্রোজেক্টে নিম্নলিখিতগুলি লিঙ্ক করুন:

  • pthread সিস্টেম লাইব্রেরি
  • CoreFoundation macOS সিস্টেম ফ্রেমওয়ার্ক
  • Foundation macOS সিস্টেম ফ্রেমওয়ার্ক
  • Security macOS সিস্টেম ফ্রেমওয়ার্ক
  • GSS macOS সিস্টেম ফ্রেমওয়ার্ক
  • Kerberos macOS সিস্টেম ফ্রেমওয়ার্ক
  • SystemConfiguration macOS সিস্টেম ফ্রেমওয়ার্ক

আরও তথ্যের জন্য আপনার কম্পাইলার ডকুমেন্টেশন দেখুন।

Linux লাইব্রেরি

Linux-এর জন্য, ৩২-বিট (i386) এবং ৬৪-বিট (x86_64) প্ল্যাটফর্মের জন্য লাইব্রেরি ভার্সন প্রদান করা হয়।

মনে রাখবেন যে Linux লাইব্রেরিগুলি GCC 4.8.0, GCC 7.2.0 এবং Ubuntu-তে Clang 5.0 ব্যবহার করে পরীক্ষা করা হয়েছে।

Linux-এ C++ ডেস্কটপ অ্যাপ তৈরি করার সময়, আপনার প্রোজেক্টে pthread সিস্টেম লাইব্রেরি লিঙ্ক করুন। আরও তথ্যের জন্য আপনার কম্পাইলার ডকুমেন্টেশন দেখুন। আপনি GCC 5 বা তার পরবর্তী ভার্সন ব্যবহার করে তৈরি করলে, -D_GLIBCXX_USE_CXX11_ABI=0 ডিফাইন করুন।

পরবর্তী ধাপ