การเริ่มต้นอย่างรวดเร็วนี้จะอธิบายวิธีตั้งค่า Firebase Crashlytics ในแอปของคุณด้วย Firebase Crashlytics SDK เพื่อให้คุณรับรายงานข้อขัดข้องที่ครอบคลุมได้ใน คอนโซล Firebase
ก่อนที่คุณจะเริ่ม
เพิ่ม Firebase ในโปรเจ็กต์ Android ของคุณหากยังไม่ได้ทำ หากคุณไม่มีแอป Android คุณสามารถดาวน์โหลด แอปตัวอย่าง ได้
ไม่บังคับ : หากต้องการรับเมตริกข้อขัดข้องเช่นผู้ใช้ที่ไม่มีข้อผิดพลาดเบรดครัมบ์และเหตุการณ์ที่กำหนดเองคุณจะต้องเปิดใช้งาน Google Analytics ในโครงการ Firebase ของคุณ
หากโครงการ Firebase ที่คุณมีอยู่ไม่ได้เปิดใช้งาน Google Analytics คุณสามารถเปิดใช้งาน Google Analytics ได้จาก แท็บ การผสานรวม ของ > การตั้งค่าโครงการ
หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์
สุดท้ายในคอนโซล Google Analytics ให้เปิดใช้งานการแชร์ข้อมูลในแท็บผู้ ดูแลระบบ > การตั้งค่าบัญชี > การตั้งค่าการแชร์ข้อมูล
สำหรับโครงการ Firebase รุ่นเก่าโปรดทราบว่าคุณอาจต้องเปิดใช้งานการแชร์ข้อมูลใน แท็บ การผสานรวม ของ > การตั้งค่าโครงการ (ในคอนโซล Firebase)
ขั้นตอนที่ 1 : ตั้งค่า Crashlytics ในคอนโซล Firebase
คลิก Crashlytics ในแผงนำทางด้านซ้ายของ คอนโซล Firebase
หากโครงการ Firebase ของคุณมีหลายแอปที่ลงทะเบียนไว้ให้เลือกแอปที่คุณเพิ่งเพิ่มจากเมนูแบบเลื่อนลงถัดจาก Crashlytics ในแถบด้านบนของคอนโซล
คลิก เปิดใช้งาน Crashlytics
ขั้นตอนที่ 2 : เพิ่ม Firebase Crashlytics ลงในแอปของคุณ
- ในไฟล์
build.gradle
ระดับโปรเจ็กต์ของคุณให้เพิ่มปลั๊กอิน Crashlytics Gradle เป็นการอ้างอิง buildscriptbuildscript { repositories { // Check that you have Google's Maven repository (if not, add it). google() } dependencies { // ... // Check that you have the Google Services Gradle plugin v4.3.2 or later // (if not, add it). classpath 'com.google.gms:google-services:4.3.5' // Add the Crashlytics Gradle plugin (be sure to add version // 2.0.0 or later if you built your app with Android Studio 4.1). classpath 'com.google.firebase:firebase-crashlytics-gradle:2.5.1' } } allprojects { repositories { // Check that you have Google's Maven repository (if not, add it). google() } }
- ในไฟล์
build.gradle
ระดับแอปของคุณให้ใช้ปลั๊กอิน Crashlytics Gradle:apply plugin: 'com.android.application' apply plugin: 'com.google.gms.google-services' // Google Services Gradle plugin // Apply the Crashlytics Gradle plugin apply plugin: 'com.google.firebase.crashlytics'
ขั้นตอนที่ 3 : เริ่มต้น Crashlytics
ใช้ Firebase Android BoM ประกาศการอ้างอิงสำหรับไลบรารี Crashlytics Android ใน ไฟล์ Gradle ของ โมดูล (ระดับแอป) (โดยทั่วไปคือ
app/build.gradle
)เพื่อประสบการณ์ที่ดีที่สุดกับ Crashlytics เราขอแนะนำให้ เปิดใช้ Google Analytics ในโครงการของคุณ นอกจากนี้ในการตั้งค่า Analytics คุณต้องเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอปของคุณ
ตรวจสอบให้แน่ใจว่าคุณใช้ BoM เวอร์ชัน 24.7.1 หรือใหม่กว่าเพื่อให้ได้ผู้ใช้และเบรดครัมบ์แบบเรียลไทม์
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:26.6.0') // Declare 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 เวอร์ชันที่เข้ากันได้เสมอ
(ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM
หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง
โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้
dependencies { // Declare 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:17.3.1' implementation 'com.google.firebase:firebase-analytics:18.0.2' }
โคตรลิน + KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:26.6.0') // Declare 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-ktx' implementation 'com.google.firebase:firebase-analytics-ktx' }
เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ
(ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM
หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง
โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้
dependencies { // Declare 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-ktx:17.3.1' implementation 'com.google.firebase:firebase-analytics-ktx:18.0.2' }
ทางเลือก : Firebase Crashlytics นำเสนอการรายงานข้อขัดข้องสำหรับแอปที่สร้างโดยใช้ Android Native Development Kit (NDK) หากแอปของคุณใช้ NDK คุณสามารถกำหนดค่า Crashlytics เพื่อรายงานข้อขัดข้องที่เกิดขึ้นในไลบรารี NDK ของแอปของคุณ ไปที่ เอกสารการรายงานข้อขัดข้องของ NDK เพื่อเรียนรู้วิธีการ
ขั้นตอนที่ 4 : ดำเนินโครงการของคุณ
สุดท้ายเรียกใช้แอปของคุณ บันทึกอุปกรณ์ของคุณแสดงการยืนยัน Firebase ว่าการเริ่มต้นเสร็จสมบูรณ์
ขั้นตอนถัดไป
ทดสอบการตั้งค่า Crashlytics โดย บังคับให้เกิดข้อขัดข้อง ในคอนโซล Firebase
ปรับแต่งการตั้งค่ารายงานข้อขัดข้องของคุณ โดยเพิ่มการเลือกใช้การรายงานบันทึกคีย์และการติดตามข้อผิดพลาดที่ไม่ร้ายแรง