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

পূর্বশর্ত

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

  • Xcode 15.2 বা তার পরে

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

     বান্ডিল সনাক্তকারী ক্ষেত্রের মান হ'ল বান্ডিল আইডি (উদাহরণস্বরূপ, com.yourcompany.yourproject )।

   • Be aware that the bundle ID value is case-sensitive, and it cannot be changed for this Firebase app after it's registered with your Firebase project.

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

   ফায়ারবেসের মধ্যে অ্যাপের ডাকনাম এবং অ্যাপ স্টোর আইডি কীভাবে ব্যবহার করা হয়?

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

   • App Store ID : Used by Firebase Dynamic Links to redirect users to your App Store page and by Google Analytics to import conversion events into Google Ads . যদি আপনার অ্যাপের এখনও অ্যাপ স্টোর আইডি না থাকে, তাহলে আপনি পরে আপনার প্রোজেক্ট সেটিংসে আইডি যোগ করতে পারেন।

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

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

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

   এই কনফিগার ফাইল সম্পর্কে আপনার কি জানা দরকার?

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

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

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

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

If you have multiple bundle IDs in your project, you must associate each bundle ID with a registered app in the Firebase console so that each app can have its own GoogleService-Info.plist file.

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

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

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

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

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

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

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

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

পদক্ষেপ 5 : আপনার অ্যাপ্লিকেশনটিতে ফায়ারবেস আরম্ভ করুন

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

1. আপনার UIApplicationDelegate এ FirebaseCore মডিউল আমদানি করুন, সেইসাথে আপনার অ্যাপ প্রতিনিধি যে কোনো 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 ইনস্টল করেছেন যাচাইকরণ পাঠাতে আপনার অ্যাপটি চালাতে পারেন।

তাই তো! You can skip ahead to the next steps .

আপনার যদি সেট আপ হতে সমস্যা হয় তবে অ্যাপল প্ল্যাটফর্মগুলি ট্রাবলশুটিং এবং এফএকিউ দেখুন।

উপলব্ধ গ্রন্থাগার

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

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

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

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

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

কোকোপডস

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

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

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

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

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

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

   • Firebase iOS SDK GitHub সংগ্রহস্থলে ।
   • ডাউনলোড করা জিপ বিতরণের মধ্যে README.md ফাইলে।

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

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

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

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

• Firebase প্রকল্পগুলি এবং প্রকল্পগুলির জন্য সর্বোত্তম অনুশীলন সম্পর্কে আরও জানতে Firebase প্রকল্পগুলি বুঝতে দেখুন ৷

• ফায়ারবেস অ্যাপের নমুনা অন্বেষণ করুন।

• Firebase iOS কোডল্যাবের সাথে অভিজ্ঞতা অর্জন করুন।

• GitHub-এ ওপেন সোর্স কোড অন্বেষণ করুন।

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

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

• Firebase এবং আপনার অ্যাপল প্রকল্পের সাথে সমস্যা হচ্ছে? অ্যাপল প্ল্যাটফর্মের সমস্যা সমাধান এবং FAQ দেখুন।

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

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

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

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

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

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

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

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