इस क्विकस्टार्ट में, Firebase Crashlytics SDK टूल की मदद से अपने ऐप्लिकेशन में Firebase Crashlytics सेट अप करने का तरीका बताया गया है. इसकी मदद से, Firebase कंसोल में क्रैश की पूरी रिपोर्ट देखी जा सकती है. Android के लिए Crashlytics का इस्तेमाल करके, ऐप्लिकेशन बंद होने, नुकसान न पहुंचाने वाली गड़बड़ियों, और "ऐप्लिकेशन काम नहीं कर रहा है" (एएनआर) की गड़बड़ियों की रिपोर्ट पाएं.
Crashlytics को सेट अप करने के लिए, Firebase कंसोल और आपके आईडीई, दोनों में टास्क जोड़े जाते हैं. जैसे, Firebase कॉन्फ़िगरेशन फ़ाइल और Crashlytics SDK टूल जोड़ना. सेटअप पूरा करने के लिए, आपको Firebase को अपनी पहली क्रैश रिपोर्ट भेजने के लिए, टेस्ट क्रैश को ज़बरदस्ती करना होगा.
वेब कंटेनर इंस्टॉल करने से पहले
अगर आपने पहले से ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें. अगर आपके पास Android ऐप्लिकेशन नहीं है, तो ऐप्लिकेशन का नमूना डाउनलोड किया जा सकता है.
सुझाव: अपने-आप ब्रेडक्रंब लॉग पाने के लिए, आपको अपने Firebase प्रोजेक्ट में Google Analytics चालू करना होगा. इससे उपयोगकर्ता की उन कार्रवाइयों को समझने में मदद मिलेगी जो क्रैश होने, नुकसान न पहुंचाने वाली या ANR इवेंट की वजह से होती हैं.
अगर आपके मौजूदा Firebase प्रोजेक्ट में Google Analytics चालू नहीं है, तो आप Firebase कंसोल में
के > प्रोजेक्ट सेटिंगइंटिग्रेशन टैब से Google Analytics को चालू कर सकते हैं. अगर कोई नया Firebase प्रोजेक्ट बनाया जा रहा है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics चालू करें.
पक्का करें कि आपके ऐप्लिकेशन में, कम से कम इन वर्शन की ज़रूरत हो:
- ग्रेडल 8.0
- 'Android Gradle प्लग इन 8.1.0'
- Google सेवाओं के लिए Gradle प्लग इन 4.4.1
पहला चरण: अपने ऐप्लिकेशन में Crashlytics SDK टूल जोड़ना
<project>/<app-module>/build.gradle.kts
<project>/<app-module>/build.gradle
लाइब्रेरी के वर्शन को कंट्रोल करने के लिए, हम Firebase Android BoM का इस्तेमाल करने का सुझाव देते हैं.
ब्रेडक्रंब लॉग का फ़ायदा पाने के लिए, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल भी जोड़ें. पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू हो.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.1")) // 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 लाइब्रेरी डिपेंडेंसी जोड़ें
अगर आप 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:19.0.2") implementation("com.google.firebase:firebase-analytics:22.0.2") }
दूसरा चरण: अपने ऐप्लिकेशन में Crashlytics Gradle प्लग इन जोड़ना
अपनी रूट-लेवल (प्रोजेक्ट-लेवल) की 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 }
अपने मॉड्यूल (ऐप्लिकेशन-लेवल) 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 डैशबोर्ड में शुरुआती डेटा देखने के लिए, आपको ज़बरदस्ती टेस्ट बंद करना होगा.
अपने ऐप्लिकेशन में ऐसा कोड जोड़ें जिसका इस्तेमाल करके, ऐप्लिकेशन के क्रैश होने की जांच की जा सके.
अपने ऐप्लिकेशन के
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));
अपना ऐप्लिकेशन बनाएं और चलाएं.
अपने ऐप्लिकेशन की पहली क्रैश रिपोर्ट भेजने के लिए टेस्ट क्रैश को हर हाल में भेजें:
अपने टेस्ट डिवाइस या एम्युलेटर से ऐप्लिकेशन खोलें.
अपने ऐप्लिकेशन में, "क्रैश की जांच करें" बटन दबाएं जिसे आपने ऊपर दिए गए कोड का इस्तेमाल करके जोड़ा है.
ऐप्लिकेशन क्रैश होने के बाद, उसे रीस्टार्ट करें, ताकि आपका ऐप्लिकेशन Firebase को क्रैश रिपोर्ट भेज सके.
अपने टेस्ट क्रैश को देखने के लिए Firebase कंसोल के Crashlytics डैशबोर्ड पर जाएं.
अगर आपने कंसोल रीफ़्रेश कर दिया है और पांच मिनट बाद भी टेस्ट क्रैश नहीं दिख रहा है, तो डीबग लॉगिंग को चालू करें. इससे आपको पता चलेगा कि आपका ऐप्लिकेशन क्रैश रिपोर्ट भेज रहा है या नहीं.
बस, हो गया. Crashlytics, अब आपके ऐप्लिकेशन के क्रैश होने, आम तौर पर होने वाली गड़बड़ियों, और ANR वाली गड़बड़ियों को मॉनिटर करता है. अपनी सभी रिपोर्ट और आंकड़ों को देखने और उनकी जांच करने के लिए, Crashlytics डैशबोर्ड पर जाएं.
अगले चरण
- ऑप्ट-इन रिपोर्टिंग, लॉग, कुंजियां, और साधारण गड़बड़ियों की ट्रैकिंग जोड़कर, अपनी क्रैश रिपोर्ट के सेटअप को अपनी पसंद के मुताबिक बनाएं.
- Google Play के साथ इंटिग्रेट करें, ताकि Google Play ट्रैक के हिसाब से, अपने Android ऐप्लिकेशन की क्रैश रिपोर्ट को सीधे Crashlytics डैशबोर्ड में फ़िल्टर किया जा सके. इससे आपको अपने डैशबोर्ड को खास बिल्ड पर बेहतर तरीके से फ़ोकस करने में मदद मिलती है.
-
Android Studio में, Crashlytics का डेटा देखें और उसे फ़िल्टर करें.
- Android Studio में ऐप्लिकेशन क्वालिटी के बारे में अहम जानकारी (एक्यूआई) विंडो का इस्तेमाल करके, अपने कोड के साथ Crashlytics से जुड़ा डेटा देखें. मुख्य समस्याओं को डीबग करने के लिए, Crashlytics के डैशबोर्ड और IDE के बीच स्विच करने की ज़रूरत नहीं पड़ती.
- Android Studio की इलेक्ट्रिक ईल रिलीज़ (स्टेबल) में एक्यूआई विंडो का ऐक्सेस पाएं या फ़्लैमिंगो (बीटा वर्शन) में नई एक्यूआई सुविधाएं आज़माएं. अपना Android Studio वर्शन डाउनलोड करें.
- Android Studio के दस्तावेज़ में, एक्यूआई विंडो इस्तेमाल करने का तरीका जानें.
- आपका जवाब पाकर हमें खुशी होगी! गड़बड़ी की रिपोर्ट दर्ज करके, एक्यूआई विंडो के बारे में हमें सुझाव/राय भेजें या शिकायत करें.