फायरबेस क्रैशलिटिक्स के साथ आरंभ करें

यह क्विकस्टार्ट वर्णन करता है कि फायरबेस क्रैशलिटिक्स एसडीके के साथ अपने ऐप में फायरबेस क्रैशलिटिक्स कैसे सेट करें ताकि आप फायरबेस कंसोल में व्यापक क्रैश रिपोर्ट प्राप्त कर सकें।एंड्रॉइड के लिए क्रैशलाइटिक्स के साथ, आपको क्रैश, गैर-घातक त्रुटियों और "एप्लिकेशन प्रतिसाद नहीं दे रहा" (एएनआर) त्रुटियों की रिपोर्ट मिलती है।

क्रैशलिटिक्स को सेट करने के लिए फायरबेस कंसोल और आपके आईडीई दोनों में कार्यों की आवश्यकता होती है (जैसे फायरबेस कॉन्फ़िगरेशन फ़ाइल और क्रैशलिटिक्स एसडीके जोड़ना)। सेटअप पूरा करने के लिए, आपको अपनी पहली क्रैश रिपोर्ट फ़ायरबेस पर भेजने के लिए एक परीक्षण क्रैश को बाध्य करना होगा।

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

  1. यदि आपने पहले से नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें । यदि आपके पास एंड्रॉइड ऐप नहीं है, तो आप एक नमूना ऐप डाउनलोड कर सकते हैं।

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

    • यदि आपके मौजूदा फायरबेस प्रोजेक्ट में Google Analytics सक्षम नहीं है, तो आप अपने एकीकरण टैब से Google Analytics सक्षम कर सकते हैं > फायरबेस कंसोल में प्रोजेक्ट सेटिंग्स

    • यदि आप एक नया फायरबेस प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण वर्कफ़्लो के दौरान Google Analytics सक्षम करें।

चरण 1 : अपने ऐप में Crashlytics SDK जोड़ें

अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle ), क्रैशलाईटिक्स लाइब्रेरी के लिए निर्भरता जोड़ें एंड्रॉयड के लिए। हम लाइब्रेरी वर्जनिंग को नियंत्रित करने के लिए फायरबेस एंड्रॉइड BoM का उपयोग करने की सलाह देते हैं।

ब्रेडक्रंब लॉग का लाभ उठाने के लिए, अपने ऐप में Google Analytics के लिए फ़ायरबेस SDK भी जोड़ें। सुनिश्चित करें कि आपके फायरबेस प्रोजेक्ट में Google Analytics सक्षम है

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.8.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")
}

फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

(वैकल्पिक) BoM का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरताएँ जोड़ें

यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता पंक्ति में निर्दिष्ट करना होगा।

ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए 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:18.6.3")
    implementation("com.google.firebase:firebase-analytics:21.6.1")
}
कोटलिन-विशिष्ट लाइब्रेरी मॉड्यूल खोज रहे हैं? अक्टूबर 2023 (फायरबेस बीओएम 32.5.0) से शुरू होकर, कोटलिन और जावा डेवलपर्स दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं (विवरण के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले प्रश्न देखें)।

चरण 2 : अपने ऐप में क्रैशलाइटिक्स ग्रैडल प्लगइन जोड़ें

  1. अपने रूट-लेवल (प्रोजेक्ट-लेवल) ग्रैडल फ़ाइल ( <project>/build.gradle.kts या <project>/build.gradle ) में, क्रैशलाइटिक्स ग्रैडल प्लगइन को plugins ब्लॉक में जोड़ें:

    Kotlin

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

    Groovy

    plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
    
        // Make sure that you have the Google services Gradle plugin dependency
        id 'com.google.gms.google-services' version '4.4.1' apply false
    
        // Add the dependency for the Crashlytics Gradle plugin
        id 'com.google.firebase.crashlytics' version '2.9.9' apply false
    }
    
  2. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.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'
    }

चरण 3 : सेटअप समाप्त करने के लिए एक परीक्षण क्रैश को बाध्य करें

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

  4. अपना परीक्षण क्रैश देखने के लिए फायरबेस कंसोल के क्रैशलाइटिक्स डैशबोर्ड पर जाएं।

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


और बस! क्रैशलाइटिक्स अब क्रैश, गैर-घातक त्रुटियों और एएनआर के लिए आपके ऐप की निगरानी कर रहा है। अपनी सभी रिपोर्ट और आँकड़े देखने और जाँचने के लिए क्रैशलाइटिक्स डैशबोर्ड पर जाएँ।

अगले कदम

  • Google Play के साथ एकीकृत करें ताकि आप अपने Android ऐप की क्रैश रिपोर्ट को Google Play ट्रैक द्वारा सीधे Crashlytics डैशबोर्ड में फ़िल्टर कर सकें। यह आपको अपने डैशबोर्ड को विशिष्ट बिल्ड पर बेहतर ढंग से केंद्रित करने की अनुमति देता है।
  • एंड्रॉइड स्टूडियो में, क्रैशलिटिक्स डेटा देखें और फ़िल्टर करें।
    • अपने कोड के साथ क्रैशलिटिक्स डेटा देखने के लिए एंड्रॉइड स्टूडियो में ऐप क्वालिटी इनसाइट्स (एक्यूआई) विंडो का उपयोग करें - शीर्ष मुद्दों को डीबग करना शुरू करने के लिए क्रैशलिटिक्स डैशबोर्ड और आईडीई के बीच आगे और पीछे कूदने की आवश्यकता नहीं है।
    • एंड्रॉइड स्टूडियो के इलेक्ट्रिक ईल रिलीज (स्थिर) में AQI विंडो तक पहुंच प्राप्त करें या फ्लेमिंगो (बीटा) में नई AQI सुविधाओं को आज़माएं। अपना इच्छित एंड्रॉइड स्टूडियो संस्करण डाउनलोड करें।
    • एंड्रॉइड स्टूडियो दस्तावेज़ में AQI विंडो का उपयोग करना सीखें।
    • हमें आपसे सुनकर अत्यंत खुशी होगी! बग रिपोर्ट दर्ज करके AQI विंडो के बारे में हमें प्रतिक्रिया भेजें।

,

यह क्विकस्टार्ट वर्णन करता है कि फायरबेस क्रैशलिटिक्स एसडीके के साथ अपने ऐप में फायरबेस क्रैशलिटिक्स कैसे सेट करें ताकि आप फायरबेस कंसोल में व्यापक क्रैश रिपोर्ट प्राप्त कर सकें।एंड्रॉइड के लिए क्रैशलाइटिक्स के साथ, आपको क्रैश, गैर-घातक त्रुटियों और "एप्लिकेशन प्रतिसाद नहीं दे रहा" (एएनआर) त्रुटियों की रिपोर्ट मिलती है।

क्रैशलिटिक्स को सेट करने के लिए फायरबेस कंसोल और आपके आईडीई दोनों में कार्यों की आवश्यकता होती है (जैसे फायरबेस कॉन्फ़िगरेशन फ़ाइल और क्रैशलिटिक्स एसडीके जोड़ना)। सेटअप पूरा करने के लिए, आपको अपनी पहली क्रैश रिपोर्ट फ़ायरबेस पर भेजने के लिए एक परीक्षण क्रैश को बाध्य करना होगा।

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

  1. यदि आपने पहले से नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें । यदि आपके पास एंड्रॉइड ऐप नहीं है, तो आप एक नमूना ऐप डाउनलोड कर सकते हैं।

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

    • यदि आपके मौजूदा फायरबेस प्रोजेक्ट में Google Analytics सक्षम नहीं है, तो आप अपने एकीकरण टैब से Google Analytics सक्षम कर सकते हैं > फायरबेस कंसोल में प्रोजेक्ट सेटिंग्स

    • यदि आप एक नया फायरबेस प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण वर्कफ़्लो के दौरान Google Analytics सक्षम करें।

चरण 1 : अपने ऐप में Crashlytics SDK जोड़ें

अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle ), क्रैशलाईटिक्स लाइब्रेरी के लिए निर्भरता जोड़ें एंड्रॉयड के लिए। हम लाइब्रेरी वर्जनिंग को नियंत्रित करने के लिए फायरबेस एंड्रॉइड BoM का उपयोग करने की सलाह देते हैं।

ब्रेडक्रंब लॉग का लाभ उठाने के लिए, अपने ऐप में Google Analytics के लिए फ़ायरबेस SDK भी जोड़ें। सुनिश्चित करें कि आपके फायरबेस प्रोजेक्ट में Google Analytics सक्षम है

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.8.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")
}

फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

(वैकल्पिक) BoM का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरताएँ जोड़ें

यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता पंक्ति में निर्दिष्ट करना होगा।

ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए 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:18.6.3")
    implementation("com.google.firebase:firebase-analytics:21.6.1")
}
कोटलिन-विशिष्ट लाइब्रेरी मॉड्यूल खोज रहे हैं? अक्टूबर 2023 (फायरबेस बीओएम 32.5.0) से शुरू होकर, कोटलिन और जावा डेवलपर्स दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं (विवरण के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले प्रश्न देखें)।

चरण 2 : अपने ऐप में क्रैशलीटिक्स ग्रेडल प्लगइन जोड़ें

  1. अपने रूट-स्तर (प्रोजेक्ट-लेवल) ग्रेडल फ़ाइल ( <project>/build.gradle.kts या <project>/build.gradle ) में, क्रैशलीटिक्स ग्रेडल प्लगइन को plugins ब्लॉक में जोड़ें:

    Kotlin

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

    Groovy

    plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
    
        // Make sure that you have the Google services Gradle plugin dependency
        id 'com.google.gms.google-services' version '4.4.1' apply false
    
        // Add the dependency for the Crashlytics Gradle plugin
        id 'com.google.firebase.crashlytics' version '2.9.9' apply false
    }
    
  2. आपके मॉड्यूल (ऐप-लेवल) ग्रेडल फ़ाइल में (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.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'
    }

चरण 3 : सेटअप खत्म करने के लिए एक परीक्षण दुर्घटना को मजबूर करें

क्रैशलीटिक्स स्थापित करने और फायरबेस कंसोल के क्रैशलीटिक्स डैशबोर्ड में प्रारंभिक डेटा देखने के लिए, आपको एक परीक्षण दुर्घटना को मजबूर करने की आवश्यकता है।

  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. आपके ऐप क्रैश होने के बाद, इसे पुनरारंभ करें ताकि आपका ऐप क्रैश रिपोर्ट को फायरबेस को भेज सके।

  4. अपने परीक्षण दुर्घटना को देखने के लिए फायरबेस कंसोल के क्रैशलीटिक्स डैशबोर्ड पर जाएं।

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


और बस! क्रैशलीटिक्स अब क्रैश, गैर-घातक त्रुटियों और एएनआरएस के लिए आपके ऐप की निगरानी कर रहा है। अपनी सभी रिपोर्टों और आंकड़ों को देखने और जांचने के लिए क्रैशलीटिक्स डैशबोर्ड पर जाएं।

अगले कदम

  • Google Play के साथ एकीकृत करें ताकि आप अपने Android ऐप की क्रैश रिपोर्ट को Google Play ट्रैक द्वारा सीधे क्रैशलीटिक्स डैशबोर्ड में फ़िल्टर कर सकें। यह आपको विशिष्ट बिल्ड पर अपने डैशबोर्ड पर बेहतर ध्यान केंद्रित करने की अनुमति देता है।
  • एंड्रॉइड स्टूडियो में, क्रैशलीटिक्स डेटा को देखें और फ़िल्टर करें।
    • अपने कोड के साथ क्रैशलीटिक्स डेटा देखने के लिए एंड्रॉइड स्टूडियो में ऐप क्वालिटी इनसाइट्स (AQI) विंडो का उपयोग करें - क्रैशलीटिक्स डैशबोर्ड और आईडीई के बीच आगे और पीछे कूदने की आवश्यकता नहीं है ताकि शीर्ष मुद्दों को डिबग करना शुरू किया जा सके।
    • एंड्रॉइड स्टूडियो के इलेक्ट्रिक ईल रिलीज़ (स्थिर) में AQI विंडो तक पहुंचें या फ्लेमिंगो (बीटा) में नई AQI सुविधाओं को आज़माएं। अपना वांछित एंड्रॉइड स्टूडियो संस्करण डाउनलोड करें।
    • Android स्टूडियो प्रलेखन में AQI विंडो का उपयोग करना सीखें।
    • हमें आपसे सुनकर अत्यंत खुशी होगी! बग रिपोर्ट दायर करके AQI विंडो के बारे में प्रतिक्रिया भेजें।