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

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


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

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

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 প্যাকেজ ম্যানেজার ব্যবহার করুন।

  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 স্ট্রাক্ট বা 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 আপনার বিল্ডের জন্য dSYMs তৈরি করে।

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

    2. আপনার সব ধরনের বিল্ডের জন্য ডিবাগিং ইনফরমেশন ফর্ম্যাট DWARF with dSYM File-এ সেট করুন।

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

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

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

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

    3. স্ক্রিপ্ট ফিল্ডে (শেল লেবেলের নিচে অবস্থিত), নিম্নলিখিত রান স্ক্রিপ্ট যোগ করুন।

      এই স্ক্রিপ্ট আপনার প্রোজেক্টের 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 ড্যাশবোর্ড দেখুন।

পরবর্তী ধাপ