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

পূর্বশর্ত

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

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

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

    অ্যাপল প্ল্যাটফর্মে Cloud Messaging জন্য, এখানে পূর্বশর্ত রয়েছে:

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

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

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

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

  1. Firebase কনসোলে , প্রজেক্ট যোগ করুন ক্লিক করুন।

    • একটি বিদ্যমান Google Cloud প্রকল্পে Firebase সংস্থান যোগ করতে, এর প্রকল্পের নাম লিখুন বা ড্রপডাউন মেনু থেকে এটি নির্বাচন করুন৷

    • একটি নতুন প্রকল্প তৈরি করতে, পছন্দসই প্রকল্পের নাম লিখুন। এছাড়াও আপনি ঐচ্ছিকভাবে প্রকল্পের নামের নীচে প্রদর্শিত প্রকল্প ID সম্পাদনা করতে পারেন৷

  2. অনুরোধ করা হলে, Firebase শর্তাবলী পর্যালোচনা করুন এবং স্বীকার করুন।

  3. অবিরত ক্লিক করুন.

  4. (ঐচ্ছিক) আপনার প্রোজেক্টের জন্য Google Analytics সেট আপ করুন, যা আপনাকে নিম্নলিখিত Firebase পণ্যগুলির যেকোনো একটি ব্যবহার করে সর্বোত্তম অভিজ্ঞতা পেতে সক্ষম করে:

    হয় একটি বিদ্যমান Google Analytics অ্যাকাউন্ট নির্বাচন করুন বা একটি নতুন অ্যাকাউন্ট তৈরি করুন৷

    আপনি যদি একটি নতুন অ্যাকাউন্ট তৈরি করেন, আপনার Analytics রিপোর্টিং অবস্থান নির্বাচন করুন, তারপর আপনার প্রকল্পের জন্য ডেটা শেয়ারিং সেটিংস এবং Google Analytics শর্তাদি গ্রহণ করুন৷

  5. প্রোজেক্ট তৈরি করুন ক্লিক করুন (বা ফায়ারবেস যোগ করুন , যদি আপনি একটি বিদ্যমান Google Cloud প্রকল্প ব্যবহার করেন)।

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

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

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

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

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

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

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

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

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

      বান্ডেল আইডেন্টিফায়ার ফিল্ডের মান হল বান্ডেল আইডি (উদাহরণস্বরূপ, com.yourcompany.yourproject )।

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

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

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

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

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

    • Firebase কনফিগারেশন ফাইলটিতে আপনার প্রকল্পের জন্য অনন্য, কিন্তু অ-গোপন শনাক্তকারী রয়েছে। এই কনফিগারেশন ফাইল সম্পর্কে আরও জানতে, Firebase প্রজেক্ট বুঝতে দেখুন।

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

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

  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
    // ...
          
    @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()
    // 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 মাধ্যমে আপনার অ্যাপ কখন এবং কেন ক্র্যাশ হচ্ছে তা খুঁজে বের করুন।