অ্যান্ড্রয়েডের জন্য ক্র্যাশলিটিক্স দিয়ে শুরু করুন

প্ল্যাটফর্ম নির্বাচন করুন: iOS+ অ্যান্ড্রয়েড অ্যান্ড্রয়েড এনডিকে ফ্লাটার ইউনিটি


এই নির্দেশিকায় বর্ণনা করা হয়েছে কীভাবে আপনার অ্যান্ড্রয়েড অ্যাপে Firebase Crashlytics ব্যবহার শুরু করবেন।

আপনার অ্যাপে Firebase Crashlytics SDK সেট আপ করার পরে, আপনি Firebase কনসোলে বিস্তারিত ক্র্যাশ রিপোর্ট পেতে পারেন। Crashlytics for Android-এর মাধ্যমে, আপনি ক্র্যাশ, নন-ফেটাল এরর এবং "অ্যাপ্লিকেশন নট রেসপন্ডিং" (ANR) এররের রিপোর্ট পান।

Crashlytics সেট আপ করার জন্য Firebase কনসোল এবং আপনার IDE উভয় স্থানেই কিছু কাজ করতে হয় (যেমন একটি ফায়ারবেস কনফিগারেশন ফাইল এবং Crashlytics SDK যোগ করা)। সেটআপ শেষ করতে, ফায়ারবেসে আপনার প্রথম ক্র্যাশ রিপোর্ট পাঠানোর জন্য আপনাকে একটি টেস্ট ক্র্যাশ ঘটাতে হবে।

শুরু করার আগে

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

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

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

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

  3. আপনার অ্যাপে নিম্নলিখিত ন্যূনতম প্রয়োজনীয় সংস্করণগুলো আছে কিনা তা নিশ্চিত করুন:

    • গ্রেডল ৮.০
    • অ্যান্ড্রয়েড গ্রেডল প্লাগইন ৮.১.০
    • গুগল পরিষেবা গ্রেডল প্লাগইন ৪.৪.১

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

আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), অ্যান্ড্রয়েডের জন্য Crashlytics লাইব্রেরির ডিপেন্ডেন্সি যোগ করুন। লাইব্রেরির ভার্সনিং নিয়ন্ত্রণের জন্য আমরা Firebase Android BoM ব্যবহার করার পরামর্শ দিই।

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.0"))

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics")
    implementation("com.google.firebase:firebase-analytics")
}

Firebase Android BoM ব্যবহার করলে, আপনার অ্যাপ সর্বদা Firebase Android লাইব্রেরিগুলোর সামঞ্জস্যপূর্ণ সংস্করণ ব্যবহার করবে।

(বিকল্প) BoM ব্যবহার না করে ফায়ারবেস লাইব্রেরি নির্ভরতা যোগ করুন

আপনি যদি Firebase BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে প্রতিটি Firebase লাইব্রেরির ভার্সন তার ডিপেন্ডেন্সি লাইনে উল্লেখ করতে হবে।

মনে রাখবেন, আপনি যদি আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করেন, তাহলে আমরা লাইব্রেরির ভার্সনগুলো পরিচালনা করার জন্য BoM অফ মেটেরিয়ালস) ব্যবহার করার জন্য দৃঢ়ভাবে সুপারিশ করি, যা সব ভার্সনের সামঞ্জস্যতা নিশ্চিত করে।

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics:20.0.4")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

ধাপ ২ : আপনার অ্যাপে Crashlytics Gradle প্লাগইনটি যোগ করুন।

  1. আপনার রুট-লেভেল (প্রজেক্ট-লেভেল) Gradle ফাইলে ( <project>/build.gradle.kts অথবা <project>/build.gradle ), plugins ব্লকে Crashlytics Gradle প্লাগইনটি যোগ করুন:

    Kotlin

    plugins {
        // Make sure that you have the AGP plugin 8.1+ dependency
        id("com.android.application") version "8.1.4" apply false
        // ...
    
        // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
        id("com.google.gms.google-services") version "4.4.4" apply false
    
        // Add the dependency for the Crashlytics Gradle plugin
        id("com.google.firebase.crashlytics") version "3.0.6" apply false
    }

    Groovy

    plugins {
        // Make sure that you have the AGP plugin 8.1+ dependency
        id 'com.android.application' version '8.1.4' apply false
        // ...
    
        // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
        id 'com.google.gms.google-services' version '4.4.4' apply false
    
        // Add the dependency for the Crashlytics Gradle plugin
        id 'com.google.firebase.crashlytics' version '3.0.6' apply false
    }
  2. আপনার মডিউল (অ্যাপ-লেভেল) Gradle ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), Crashlytics Gradle প্লাগইনটি যোগ করুন:

    Kotlin

    plugins {
      id("com.android.application")
      // ...
    
      // Make sure that you have the Google services Gradle plugin
      id("com.google.gms.google-services")
    
      // Add the Crashlytics Gradle plugin
      id("com.google.firebase.crashlytics")
    }

    Groovy

    plugins {
      id 'com.android.application'
      // ...
    
      // Make sure that you have the Google services Gradle plugin
      id 'com.google.gms.google-services'
    
      // Add the Crashlytics Gradle plugin
      id 'com.google.firebase.crashlytics'
    }

ধাপ ৩ : সেটআপ শেষ করতে একটি টেস্ট ক্র্যাশ ঘটান।

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

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

    আপনার অ্যাপের MainActivity তে নিম্নলিখিত কোডটি ব্যবহার করে আপনি এমন একটি বাটন যোগ করতে পারেন, যা চাপলে অ্যাপটি ক্র্যাশ করবে। বাটনটির লেবেল হলো "Test Crash"।

    Kotlin

    val crashButton = Button(this)
    crashButton.text = "Test Crash"
    crashButton.setOnClickListener {
       throw RuntimeException("Test Crash") // Force a crash
    }
    
    addContentView(crashButton, ViewGroup.LayoutParams(
           ViewGroup.LayoutParams.MATCH_PARENT,
           ViewGroup.LayoutParams.WRAP_CONTENT))

    Java

    Button crashButton = new Button(this);
    crashButton.setText("Test Crash");
    crashButton.setOnClickListener(new View.OnClickListener() {
       public void onClick(View view) {
           throw new RuntimeException("Test Crash"); // Force a crash
       }
    });
    
    addContentView(crashButton, new ViewGroup.LayoutParams(
           ViewGroup.LayoutParams.MATCH_PARENT,
           ViewGroup.LayoutParams.WRAP_CONTENT));
  2. আপনার অ্যাপটি তৈরি করুন এবং চালান।

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

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

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

    3. আপনার অ্যাপটি ক্র্যাশ করার পর, এটিকে পুনরায় চালু করুন যাতে এটি ফায়ারবেস-এ ক্র্যাশ রিপোর্ট পাঠাতে পারে।

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

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


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

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

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

  • Google Play সাথে ইন্টিগ্রেট করুন , যাতে আপনি সরাসরি Crashlytics ড্যাশবোর্ডে Google Play ট্র্যাক অনুযায়ী আপনার অ্যান্ড্রয়েড অ্যাপের ক্র্যাশ রিপোর্টগুলো ফিল্টার করতে পারেন। এর ফলে আপনি নির্দিষ্ট বিল্ডগুলোর ওপর আপনার ড্যাশবোর্ডকে আরও ভালোভাবে ফোকাস করতে পারবেন।

  • অ্যান্ড্রয়েড স্টুডিওতে Crashlytics ডেটা দেখুন এবং ফিল্টার করুন।

    • আপনার কোডের পাশাপাশি Crashlytics ডেটা দেখার জন্য অ্যান্ড্রয়েড স্টুডিও-এর অ্যাপ কোয়ালিটি ইনসাইটস (AQI) উইন্ডোটি ব্যবহার করুন — প্রধান সমস্যাগুলো ডিবাগ করা শুরু করার জন্য Crashlytics ড্যাশবোর্ড এবং IDE-এর মধ্যে বারবার যাওয়া-আসার কোনো প্রয়োজন নেই।
    • অ্যান্ড্রয়েড স্টুডিও ডকুমেন্টেশন থেকে AQI উইন্ডো কীভাবে ব্যবহার করতে হয় তা জেনে নিন।
    • আমরা আপনার মতামত জানতে আগ্রহী! একটি বাগ রিপোর্ট দাখিল করে AQI উইন্ডো সম্পর্কে আমাদের প্রতিক্রিয়া জানান।

  • উন্নত বিশ্লেষণ এবং বিভিন্ন ফিচারের জন্য, যেমন আপনার ডেটা কোয়েরি করা, কাস্টম ড্যাশবোর্ড তৈরি করা এবং কাস্টম অ্যালার্ট সেট আপ করার জন্য, আপনার ডেটা BigQuery বা Cloud Logging এ এক্সপোর্ট করুন