Apple প্ল্যাটফর্মের জন্য Crashlytics ব্যবহার শুরু করা

প্ল্যাটফর্ম বেছে নিন: iOS+ Android Android NDK Flutter Unity


এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে Apple প্ল্যাটফর্ম অ্যাপে (যেমন, iOS অ্যাপ) Firebase Crashlytics ব্যবহার শুরু করবেন।

আপনার অ্যাপে Firebase Crashlytics SDK সেট-আপ করার পরে, আপনি Firebase কনসোলে বিস্তারিত ক্র্যাশ রিপোর্ট পেতে পারবেন। Crashlytics Apple প্ল্যাটফর্মের জন্য, আপনি ক্র্যাশ ও নন-ফ্যাটাল সমস্যার রিপোর্ট পাবেন।

AI সহায়তা পেতে, নিচে দেওয়া প্রম্পটটি আপনার AI কোডিং এজেন্টে (যেমন Antigravity, Claude Code, Codex ও Cursor) কপি করুন। আপনি প্রম্পট কাস্টমাইজ করতে এবং এজেন্টের সাথে আইটেরেট করতে পারবেন। ইনস্টলেশন সংক্রান্ত বিস্তারিত তথ্য পেতে Firebase এজেন্ট দক্ষতা দেখুন। 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Firebase Crashlytics for my app.

শুরু করার আগে

Crashlytics সেট-আপ করার জন্য Firebase কনসোল ও আপনার IDE (যেমন, Firebase কনফিগারেশন ফাইল ও Crashlytics SDK যোগ করা) দুটিতেই টাস্ক প্রয়োজন। সেট-আপ সম্পূর্ণ করতে, Firebase-এ আপনার প্রথম ক্র্যাশ রিপোর্ট পাঠানোর জন্য আপনাকে একটি টেস্ট ক্র্যাশ করতে হবে।

  1. আপনি আগে থেকে না করে থাকলে, আপনার Apple প্রোজেক্টে Firebase যোগ করুন। আপনার কাছে Apple অ্যাপ না থাকলে, আপনি একটি স্যাম্পেল অ্যাপ ডাউনলোড করতে পারবেন।

  2. সাজেস্ট করা: ক্র্যাশ বা নন-ফ্যাটাল ইভেন্টের আগে ব্যবহারকারীর অ্যাকশন বুঝতে ব্রেডক্রাম্ব লগ অটোমেটিক পেতে Firebase প্রোজেক্টে Google Analytics চালু করতে হবে।

    • আপনি নতুন Firebase প্রোজেক্ট তৈরি করলে, প্রোজেক্ট তৈরি করার ওয়ার্কফ্লো চলাকালীন Google Analytics চালু করুন।

    • আপনি যদি এমন কোনও আগে থেকে থাকা Firebase প্রোজেক্ট ব্যবহার করেন যেখানে Google Analytics চালু করা নেই, তাহলে আপনি Firebase কনসোলের সেটিংস > ইন্টিগ্রেশন পৃষ্ঠা থেকে এটি চালু করতে পারবেন।

    মনে রাখবেন, watchOS ছাড়া Crashlytics Apple-এর সব প্ল্যাটফর্মের জন্য ব্রেডক্রাম্ব লগ উপলভ্য।

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

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

  1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলা থাকা অবস্থায়, ফাইল > প্যাকেজ যোগ করুন বিকল্পে নেভিগেট করুন।
  2. প্রম্পট করা হলে, Firebase Apple প্ল্যাটফর্ম SDK রিপোজিটরি যোগ করুন:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Crashlytics লাইব্রেরি বেছে নিন।
  4. ব্রেডক্রাম্ব লগ-এর সুবিধা নিতে, আপনার অ্যাপে Google Analytics-এর জন্য Firebase SDK যোগ করুন। নিশ্চিত করুন যে আপনার Firebase প্রোজেক্টে Google Analytics চালু করা আছে।
  5. আপনার টার্গেটের বিল্ড সেটিংসের অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে -ObjC ফ্ল্যাগ যোগ করুন।
  6. (শুধুমাত্র macOS) আপনার Info.plist-এ, কী যোগ করুন NSApplicationCrashOnExceptions এবং এটিকে YES হিসেবে সেট করুন।
  7. এটি সম্পূর্ণ হয়ে গেলে, Xcode অটোমেটিক আপনার ডিপেন্ডেন্সি ব্যাকগ্রাউন্ডে সমাধান ও ডাউনলোড করা শুরু করবে।

এরপরে, Firebase মডিউল কনফিগার করুন:

  1. আপনার App struct বা UIApplicationDelegate-এ Firebase মডিউল ইমপোর্ট করুন:

    Swift 

    import Firebase

    Objective-C 

    @import Firebase;

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

    Swift 

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

    Objective-C 

    // Use the Firebase library to configure APIs.
[FIRApp configure];

ধাপ ২: dSYM ফাইল অটোমেটিক আপলোড করার জন্য Xcode সেট-আপ করুন

মানুষের পক্ষে পাঠযোগ্য ক্র্যাশ রিপোর্ট তৈরি করতে, Crashlytics-এর আপনার প্রোজেক্টের ডিবাগ সিম্বল (dSYM) ফাইল প্রয়োজন। আপনি যখনই অ্যাপ তৈরি করেন, তখন কীভাবে Xcode কনফিগার করে আপনার dSYM অটোমেটিক তৈরি, প্রসেস ও ফাইল আপলোড করবেন তা নিম্নলিখিত ধাপগুলি থেকে জানতে পারবেন।

  1. আপনার প্রোজেক্টের Xcode ওয়ার্কস্পেস খুলুন, তারপর বাঁদিকের নেভিগেটরে গিয়ে এর প্রোজেক্ট ফাইল বেছে নিন।

  2. টার্গেট তালিকা থেকে, আপনার মূল বিল্ড টার্গেট বেছে নিন।

  3. বিল্ড সেটিংস ট্যাবে ক্লিক করুন, তারপর নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন যাতে Xcode আপনার বিল্ডের জন্য dSYM তৈরি করে।

    1. সব বিকল্পে ক্লিক করে debug information format সার্চ করুন।

    2. আপনার সব বিল্ড ধরনের জন্য ডিবাগ তথ্য ফর্ম্যাট DWARF with dSYM File হিসেবে সেট করুন।

  4. বিল্ড ফেজ ট্যাবে ক্লিক করুন, তারপর নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন যাতে Xcode আপনার dSYMs প্রসেস করতে এবং ফাইল আপলোড করতে পারে।

    1. > নতুন রান স্ক্রিপ্ট ফেজ বিকল্পে ক্লিক করুন।

      নিশ্চিত করুন যে এই নতুন রান স্ক্রিপ্ট ফেজটি আপনার প্রোজেক্টের শেষ বিল্ড ফেজ; অন্যথায়, Crashlytics dSYMs সঠিকভাবে প্রসেস করতে পারবে না।

    2. নতুন স্ক্রিপ্ট রান করুন বিভাগটি বড় করুন।

    3. স্ক্রিপ্ট ফিল্ডে (Shell লেবেলের নিচে থাকে), নিচে দেওয়া রান স্ক্রিপ্ট যোগ করুন।

      এই স্ক্রিপ্ট আপনার প্রোজেক্টের dSYM ফাইল প্রসেস করে এবং ফাইলগুলি Crashlytics-এ আপলোড করে।

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"

    4. ইনপুট ফাইল বিভাগে, নিম্নলিখিত ফাইলের লোকেশনের পাথ যোগ করুন:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
       
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
       
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
       
      $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
       
      $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)
       আপনার প্রোজেক্ট বিল্ড সেটিংসে ENABLE_USER_SCRIPT_SANDBOXING=YES এবং ENABLE_DEBUG_DYLIB=YES থাকলে, নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত করুন: 
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}.debug.dylib

dSYM ফাইল ও Crashlytics (dSYM ফাইল কীভাবে ম্যানুয়ালি আপলোড করতে হয় সহ) সম্পর্কে আরও বিস্তারিত তথ্য পেতে, এখানে যান: ডিমিস্ট্রিফাই করা ক্র্যাশ রিপোর্ট পান।

ধাপ ৩: সেট-আপ সম্পূর্ণ করতে জোর করে একটি টেস্ট ক্র্যাশ করুন

Crashlytics সেট-আপ করা সম্পূর্ণ করতে এবং Firebase কনসোলের Crashlytics ড্যাশবোর্ডে প্রাথমিক ডেটা দেখতে, আপনাকে জোর করে একটি টেস্ট ক্র্যাশ করতে হবে।

  1. আপনার অ্যাপে এমন কোড যোগ করুন যা ব্যবহার করে আপনি জোর করে টেস্ট ক্র্যাশ করতে পারবেন।

    আপনার অ্যাপে একটি বোতাম যোগ করতে আপনি নিম্নলিখিত কোড ব্যবহার করতে পারেন যা প্রেস করলে ক্র্যাশ হয়। বোতামে "টেস্ট ক্র্যাশ" লেবেল দেওয়া আছে।

    SwiftUI 

    Button("Crash") {
  fatalError("Crash was triggered")
}

    UIKit

    Swift 

    import UIKit

class ViewController: UIViewController {
  override func viewDidLoad() {
      super.viewDidLoad()

      // Do any additional setup after loading the view, typically from a nib.

      let button = UIButton(type: .roundedRect)
      button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
      button.setTitle("Test Crash", for: [])
      button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
      view.addSubview(button)
  }

  @IBAction func crashButtonTapped(_ sender: AnyObject) {
      let numbers = [0]
      let _ = numbers[1]
  }
}

    Objective-C 

    #import "ViewController.h"

@implementation ViewController
‐ (void)viewDidLoad {
    [super viewDidLoad];

    // Do any additional setup after loading the view, typically from a nib.

    UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
    button.frame = CGRectMake(20, 50, 100, 30);
    [button setTitle:@"Test Crash" forState:UIControlStateNormal];
    [button addTarget:self action:@selector(crashButtonTapped:)
        forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:button];
}

‐ (IBAction)crashButtonTapped:(id)sender {
    @[][1];
}

@end

  2. Xcode ডিবাগার ডিসকানেক্ট করে Xcode-এ আপনার অ্যাপ তৈরি ও রান করুন।

    1. টেস্ট ডিভাইস বা সিমুলেটরে আপনার অ্যাপ তৈরি করতে, তৈরি করুন এবং তারপরে বর্তমান স্কিম রান করান বিকল্পে ক্লিক করুন।

    2. আপনার অ্যাপ চালু না হওয়া পর্যন্ত অপেক্ষা করুন, তারপর আপনার অ্যাপের প্রাথমিক ইনস্ট্যান্স বন্ধ করতে স্কিম বা অ্যাকশন চালানো বন্ধ করুন বিকল্পে ক্লিক করুন। এই প্রাথমিক ইনস্ট্যান্সে ডিবাগার অন্তর্ভুক্ত ছিল যা Crashlytics-এর সাথে ইন্টারফেয়ার করে।

  3. আপনার অ্যাপের প্রথম ক্র্যাশ রিপোর্ট পাঠানোর জন্য জোর করে টেস্ট ক্র্যাশ করুন:

    1. আপনার টেস্ট ডিভাইস বা সিমুলেটরের হোম স্ক্রিন থেকে অ্যাপ খুলুন।

    2. আপনার অ্যাপে, উপরে দেওয়া কোড ব্যবহার করে আপনি যে "টেস্ট ক্র্যাশ" বোতামটি যোগ করেছেন সেটি প্রেস করুন ।

    3. আপনার অ্যাপ ক্র্যাশ করার পরে, Xcode থেকে এটি আবার রান করুন যাতে আপনার অ্যাপ Firebase-এ ক্র্যাশ রিপোর্ট পাঠাতে পারে।

  4. Firebase কনসোলে, DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ডে গিয়ে আপনার টেস্ট ক্র্যাশ রিপোর্ট চেক করুন।

    আপনি কনসোল রিফ্রেশ করার পরেও পাঁচ মিনিট পরে টেস্ট ক্র্যাশ দেখতে না পেলে, আপনার অ্যাপ ক্র্যাশ রিপোর্ট পাঠাচ্ছে কিনা তা দেখতে ডিবাগ লগিং চালু করুন।


এই পর্যন্তই! Crashlytics এখন আপনার অ্যাপ ক্র্যাশ করছে কিনা তা মনিটর করছে। আপনার সব রিপোর্ট ও পরিসংখ্যান দেখতে ও তদন্ত করতে Crashlytics ড্যাশবোর্ড দেখুন।

পরবর্তী ধাপ