Firebase Crashlytics का इस्तेमाल शुरू करें

iOS+ Android फ़्लटर यूनिटी

इस क्विकस्टार्ट में, ऐप्लिकेशन में Firebase Crashlytics को सेट अप करने का तरीका बताया गया है Firebase Crashlytics SDK टूल का इस्तेमाल करें, ताकि ऐप्लिकेशन क्रैश होने की पूरी जानकारी मिल सके रिपोर्ट देखें. Crshlytics के साथ Android के लिए, आपको क्रैश, सामान्य गड़बड़ियों, और "ऐप्लिकेशन काम नहीं कर रहा है" (ANR) की गड़बड़ियां.

Crashlytics को सेट अप करने के लिए, Firebase कंसोल और आपका IDE (जैसे, Firebase कॉन्फ़िगरेशन फ़ाइल और Crashlytics जोड़ना) SDK टूल). सेटअप पूरा करने के लिए, आपको पहले टेस्ट क्रैश को ज़बरदस्ती भेजना होगा Firebase को क्रैश रिपोर्ट.

शुरू करने से पहले

1. अगर आपने पहले से Firebase नहीं जोड़ा है, तो अपने Android में Firebase जोड़ें प्रोजेक्ट. अगर आपके पास Android ऐप्लिकेशन नहीं है, तो ऐप्लिकेशन का नमूना.

2. सुझाव: अपने आप पाने के लिए ब्रेडक्रंब लॉग उपयोगकर्ता की उन कार्रवाइयों को समझने के लिए जिनकी वजह से क्रैश, नॉन-घातक या ANR इवेंट होता है. आपको अपने Firebase प्रोजेक्ट में Google Analytics चालू करना होगा.

   • अगर आपके मौजूदा Firebase प्रोजेक्ट में Google Analytics नहीं है चालू है, तो आप इनसे Google Analytics को चालू कर सकते हैं: आपके इंटिग्रेशन टैब settings > प्रोजेक्ट सेटिंग देखें.

   • अगर कोई नया Firebase प्रोजेक्ट बनाया जा रहा है, तो Google Analytics चालू करें का इस्तेमाल करते हैं.

3. पक्का करें कि आपके ऐप्लिकेशन में, कम से कम इन वर्शन की ज़रूरत हो:

   • ग्रेडल 8.0
   • 'Android Gradle प्लग इन 8.1.0'
   • Google सेवाओं के लिए Gradle प्लग इन 4.4.1

पहला चरण: अपने ऐप्लिकेशन में Crashlytics SDK टूल जोड़ना

ब्रेडक्रंब लॉग का फ़ायदा लेने के लिए, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल भी जोड़ें. पक्का करें कि Google Analytics चालू है आपके Firebase प्रोजेक्ट में.

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

    // 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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

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:19.0.3")
    implementation("com.google.firebase:firebase-analytics:22.0.2")
}

दूसरा चरण: अपने ऐप्लिकेशन में 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.2" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "3.0.2" 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.2' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '3.0.2' 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 में इस कोड का इस्तेमाल किया जा सकता है ऐप्लिकेशन को दबाते ही, क्रैश हो जाता है. बटन को लेबल किया गया है "क्रैश की जांच".

   Kotlin+KTX

   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. ऐप्लिकेशन क्रैश होने के बाद, उसे रीस्टार्ट करें, ताकि आपका ऐप्लिकेशन क्रैश होने की जानकारी भेज सके Firebase को रिपोर्ट करें.

4. इसके बाद, Crashlytics डैशबोर्ड पर जाएं Firebase कंसोल देखें.

   अगर आपने कंसोल रीफ़्रेश कर दिया है और आपको अब भी टेस्ट क्रैश नहीं दिख रहा है, तो पाँच मिनट बाद, डीबग लॉगिंग चालू करें यह देखने के लिए कि आपका ऐप्लिकेशन क्रैश रिपोर्ट भेज रहा है या नहीं.

बस, हो गया. Crashlytics, नुकसान न पहुंचाने वाले और क्रैश का पता लगाने के लिए, अब आपके ऐप्लिकेशन को मॉनिटर कर रहा है और ANR की गड़बड़ियां. देखने और जांच करने के लिए, Crashlytics डैशबोर्ड पर जाएं अपनी सभी रिपोर्ट और आंकड़ों की समीक्षा कर सकते हैं.

अगले चरण

• क्रैश रिपोर्ट के सेटअप को पसंद के मुताबिक बनाना इसके लिए ऑप्ट-इन रिपोर्टिंग, लॉग, कुंजियां, और साधारण गड़बड़ियों की ट्रैकिंग जोड़ें.

• Google Play के साथ इंटिग्रेट करना, ताकि तो आपके पास अपने Android ऐप्लिकेशन की क्रैश रिपोर्ट को Google Play ट्रैक के हिसाब से फ़िल्टर करने का विकल्प होता है. Crashlytics का डैशबोर्ड. इससे आपको अपने डैशबोर्ड को खास बिल्ड पर बेहतर तरीके से फ़ोकस करने में मदद मिलती है.

• Android Studio में, Crashlytics का डेटा देखें और उसे फ़िल्टर करें.
  • Crashlytics का डेटा देखने के लिए, Android Studio में ऐप्लिकेशन क्वालिटी से जुड़ी अहम जानकारी (एक्यूआई) विंडो का इस्तेमाल करें डेटा को इकट्ठा और उसका इस्तेमाल करता है — इसके लिए आपको Crashlytics के बीच आगे-पीछे जाने की ज़रूरत नहीं पड़ती डैशबोर्ड और IDE का इस्तेमाल करें.
  • Android Studio के इलेक्ट्रिक ईल की रिलीज़ (स्टेबल) वीडियो में एक्यूआई विंडो का ऐक्सेस पाएं या इसे आज़माकर देखें फ़्लमिंगो (बीटा वर्शन) में एक्यूआई की नई सुविधाएं. अपना Android Studio वर्शन डाउनलोड करें.
  • ज़्यादा जानें Android Studio के दस्तावेज़ में, एक्यूआई विंडो इस्तेमाल करने का तरीका बताया गया है.
  • आपका जवाब पाकर हमें खुशी होगी! एक्यूआई विंडो के बारे में हमें इस हिसाब से सुझाव, शिकायत या राय भेजें गड़बड़ी की रिपोर्ट दर्ज कर रहे हैं.