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

পূর্বশর্ত

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

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

    • আপনার প্রজেক্টকে অবশ্যই এই প্ল্যাটফর্ম সংস্করণগুলিকে লক্ষ্য করতে হবে বা পরবর্তীতে:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7
  • একটি শারীরিক অ্যাপল ডিভাইস সেট আপ করুন বা আপনার অ্যাপ চালানোর জন্য একটি সিমুলেটর ব্যবহার করুন।

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

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

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

ধাপ 2 : Firebase-এ আপনার অ্যাপ নিবন্ধন করুন

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

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

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

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

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

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

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

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

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

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

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

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

ফায়ারবেস নির্ভরতা ইনস্টল এবং পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

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

    যদি আপনার Firebase প্রকল্পে Google Analytics সক্ষম করা থাকে, তাহলে FirebaseAnalytics যোগ করতে ভুলবেন না। IDFA সংগ্রহের ক্ষমতা ছাড়া Analytics-এর জন্য, পরিবর্তে FirebaseAnalyticsWithoutAdId যোগ করুন।

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

ধাপ 5 : আপনার অ্যাপে ফায়ারবেস শুরু করুন

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

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

    সুইফটইউআই

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

    সুইফট

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    উদ্দেশ্য-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. আপনার অ্যাপ প্রতিনিধির application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে একটি FirebaseApp শেয়ার করা উদাহরণ কনফিগার করুন:

    সুইফটইউআই

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

    সুইফট

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

    উদ্দেশ্য-C

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

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

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

পরিষেবা বা পণ্য শুঁটি সুইফটপিএম লাইব্রেরি Google Analytics ."> Analytics যোগ করবেন?
AdMob pod 'Google-Mobile-Ads-SDK' N/A
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
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(প্রয়োজনীয়)
Firebase ইনস্টলেশন pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML কাস্টম মডেল APIs pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

সুইফট প্যাকেজ ম্যানেজার ব্যবহার না করেই ইন্টিগ্রেট করুন

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

কোকোপডস

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

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

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

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

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

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

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

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

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

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

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

  • Analytics সাথে ব্যবহারকারীর আচরণ সম্পর্কে অন্তর্দৃষ্টি অর্জন করুন।

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

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

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

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

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

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