Firebase Crashlytics দিয়ে শুরু করুন

এই কুইকস্টার্ট বর্ণনা করে কিভাবে আপনার অ্যাপে Crashlytics Flutter প্লাগইন দিয়ে Firebase Crashlytics সেট আপ করবেন যাতে আপনি Firebase কনসোলে ব্যাপক ক্র্যাশ রিপোর্ট পেতে পারেন।

Crashlytics সেট আপ করার জন্য একটি কমান্ড-লাইন টুল এবং আপনার IDE উভয়ই ব্যবহার করা জড়িত। সেটআপ শেষ করার জন্য, Firebase-এ আপনার প্রথম ক্র্যাশ রিপোর্ট পাঠানোর জন্য আপনাকে একটি পরীক্ষা ব্যতিক্রম থ্রো করতে বাধ্য করতে হবে।

তুমি শুরু করার আগে

  1. যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার ফ্লটার প্রজেক্টে Firebase কনফিগার করুন এবং আরম্ভ করুন ।

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

    • যদি আপনার বিদ্যমান ফায়ারবেস প্রকল্পে Google Analytics সক্ষম না থাকে, তাহলে আপনি আপনার ইন্টিগ্রেশন ট্যাব থেকে Google Analytics সক্ষম করতে পারেন > Firebase কনসোলে প্রকল্প সেটিংস ।

    • আপনি যদি একটি নতুন ফায়ারবেস প্রজেক্ট তৈরি করেন, তাহলে প্রোজেক্ট তৈরির ওয়ার্কফ্লো চলাকালীন Google Analytics সক্ষম করুন।

    মনে রাখবেন যে ব্রেডক্রাম্ব লগগুলি ক্র্যাশলিটিক্স (ওয়াচওএস ছাড়া) দ্বারা সমর্থিত সমস্ত অ্যান্ড্রয়েড এবং অ্যাপল প্ল্যাটফর্মের জন্য উপলব্ধ।

ধাপ 1 : আপনার ফ্লাটার প্রকল্পে ক্র্যাশলাইটিক্স যোগ করুন

  1. আপনার ফ্লাটার প্রোজেক্টের রুট থেকে, ক্র্যাশলিটিক্সের জন্য ফ্লাটার প্লাগইন ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান।

    ব্রেডক্রাম্ব লগের সুবিধা নিতে, আপনার অ্যাপে Google Analytics-এর জন্য Flutter প্লাগইন যোগ করুন। আপনার Firebase প্রোজেক্টে Google Analytics চালু আছে কিনা তা নিশ্চিত করুন।

    flutter pub add firebase_crashlytics && flutter pub add firebase_analytics

  2. আপনার ফ্লটার প্রকল্পের রুট ডিরেক্টরি থেকে, নিম্নলিখিত কমান্ডটি চালান:

    flutterfire configure

    এই কমান্ডটি চালানো নিশ্চিত করে যে আপনার ফ্লটার অ্যাপের ফায়ারবেস কনফিগারেশন আপ-টু-ডেট এবং অ্যান্ড্রয়েডের জন্য, আপনার অ্যাপে প্রয়োজনীয় ক্র্যাশলিটিক্স গ্রেডল প্লাগইন যোগ করে।

  3. একবার সম্পূর্ণ হয়ে গেলে, আপনার ফ্লাটার প্রকল্পটি পুনর্নির্মাণ করুন:

    flutter run

  4. (ঐচ্ছিক) যদি আপনার ফ্লাটার প্রকল্প --split-debug-info পতাকা ব্যবহার করে (এবং, ঐচ্ছিকভাবে, --obfuscate পতাকাও) ব্যবহার করে, আপনার অ্যাপের জন্য পঠনযোগ্য স্ট্যাক ট্রেস দেখানোর জন্য অতিরিক্ত পদক্ষেপের প্রয়োজন।

    • অ্যাপল প্ল্যাটফর্ম: নিশ্চিত করুন যে আপনার প্রকল্প প্রস্তাবিত সংস্করণ কনফিগারেশন (ফ্লাটার 3.12.0+ এবং ক্র্যাশলিটিক্স ফ্লাটার প্লাগইন 3.3.4+) ব্যবহার করছে যাতে আপনার প্রকল্প স্বয়ংক্রিয়ভাবে ক্র্যাশলিটিক্সে ফ্লাটার চিহ্ন (dSYM ফাইল) তৈরি এবং আপলোড করতে পারে।

    • Android: Flutter ডিবাগ চিহ্ন আপলোড করতে Firebase CLI (v.11.9.0+) ব্যবহার করুন। অস্পষ্ট কোড বিল্ড থেকে ক্র্যাশ রিপোর্ট করার আগে আপনাকে ডিবাগ চিহ্নগুলি আপলোড করতে হবে।

      আপনার ফ্লটার প্রকল্পের রুট ডিরেক্টরি থেকে, নিম্নলিখিত কমান্ডটি চালান:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/symbols

      • FIREBASE_APP_ID : আপনার Firebase Android App ID (আপনার প্যাকেজের নাম নয়)
        উদাহরণ ফায়ারবেস অ্যান্ড্রয়েড অ্যাপ আইডি: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO /symbols : অ্যাপ্লিকেশন তৈরি করার সময় আপনি --split-debug-info ফ্ল্যাগে যে ডিরেক্টরিটি পাস করেন

ধাপ 2 : ক্র্যাশ হ্যান্ডলার কনফিগার করুন

আপনি FirebaseCrashlytics.instance.recordFlutterFatalError এর সাথে FlutterError.onError ওভাররাইড করে Flutter ফ্রেমওয়ার্কের মধ্যে নিক্ষিপ্ত সমস্ত ত্রুটি স্বয়ংক্রিয়ভাবে ধরতে পারেন:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();

  // Pass all uncaught "fatal" errors from the framework to Crashlytics
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  runApp(MyApp());
}

Flutter ফ্রেমওয়ার্ক দ্বারা পরিচালিত হয় না এমন অ্যাসিঙ্ক্রোনাস ত্রুটিগুলি ধরতে, PlatformDispatcher.instance.onError ব্যবহার করুন :

Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    FlutterError.onError = (errorDetails) {
      FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
    };
    // Pass all uncaught asynchronous errors that aren't handled by the Flutter framework to Crashlytics
    PlatformDispatcher.instance.onError = (error, stack) {
      FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
      return true;
    };
    runApp(MyApp());

}

অন্যান্য ধরণের ত্রুটিগুলি কীভাবে পরিচালনা করবেন তার উদাহরণগুলির জন্য, ক্র্যাশ রিপোর্টগুলি কাস্টমাইজ করুন দেখুন৷

ধাপ 3 : সেটআপ শেষ করতে একটি পরীক্ষা ক্র্যাশ বাধ্য করুন

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

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

    আপনি যদি শীর্ষ-স্তরের Zone FirebaseCrashlytics.instance.recordError(error, stack, fatal: true) কল করে এমন একটি ত্রুটি হ্যান্ডলার যোগ করে থাকেন, তাহলে আপনি আপনার অ্যাপে একটি বোতাম যোগ করতে নিম্নলিখিত কোডটি ব্যবহার করতে পারেন যেটি চাপলে থ্রো হয় একটি পরীক্ষা ব্যতিক্রম:

    TextButton(
    onPressed: () => throw Exception(),
    child: const Text("Throw Test Exception"),
),

  2. আপনার অ্যাপ তৈরি করুন এবং চালান।

  3. আপনার অ্যাপের প্রথম রিপোর্ট পাঠানোর জন্য পরীক্ষার ব্যতিক্রম থ্রো করতে বাধ্য করুন:

    1. আপনার পরীক্ষা ডিভাইস বা এমুলেটর থেকে আপনার অ্যাপ্লিকেশন খুলুন.

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

  4. আপনার পরীক্ষা ক্র্যাশ দেখতে Firebase কনসোলের Crashlytics ড্যাশবোর্ডে যান।

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


এবং এটাই! Crashlytics এখন আপনার অ্যাপ ক্র্যাশের জন্য এবং Android-এ অ-মরণীয় ত্রুটি এবং ANR-এর জন্য নজরদারি করছে। আপনার সমস্ত রিপোর্ট এবং পরিসংখ্যান দেখতে এবং তদন্ত করতে Crashlytics ড্যাশবোর্ডে যান।

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