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

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

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

শুরু করার আগে

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

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

   • যদি আপনার বিদ্যমান Firebase প্রকল্পে Google Analytics সক্ষম না থাকে, তাহলে আপনি আপনার Integrations ট্যাব থেকে Google Analytics সক্ষম করতে পারেন settings > Firebase কনসোলে প্রজেক্ট সেটিংস ।

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

   মনে রাখবেন যে ব্রেডক্রাম্ব লগগুলি Crashlytics দ্বারা সমর্থিত সমস্ত Android এবং Apple প্ল্যাটফর্মের জন্য উপলব্ধ (watchOS ব্যতীত)।

ধাপ ১ : আপনার ফ্লটার প্রজেক্টে Crashlytics যোগ করুন

1. আপনার Flutter প্রকল্পের মূল থেকে, Crashlytics এর জন্য Flutter প্লাগইন ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান।

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

   flutter pub add firebase_crashlytics && flutter pub add firebase_analytics
   

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

   flutterfire configure
   

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

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

   flutter run
   

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

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

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

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

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

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

       আপনার Firebase অ্যাপ আইডি খুঁজে বের করতে হবে?

       আপনার Firebase অ্যাপ আইডি খুঁজে বের করার দুটি উপায় এখানে দেওয়া হল:

       • আপনার google-services.json ফাইলে, আপনার অ্যাপ আইডি হল mobilesdk_app_id মান; অথবা

       • Firebase কনসোলে, আপনার Project settings এ যান। Your apps কার্ডে স্ক্রোল করুন, তারপর পছন্দসই Firebase অ্যাপের অ্যাপ আইডি খুঁজে পেতে তার উপর ক্লিক করুন।

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

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

FlutterError.onError FirebaseCrashlytics.instance.recordFlutterFatalError করে 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());
}

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());

}