เริ่มต้นกับ Firebase Crashlytics

การเริ่มต้นอย่างรวดเร็วนี้จะอธิบายวิธีตั้งค่า Firebase Crashlytics ในแอปของคุณด้วย Firebase Crashlytics SDK เพื่อให้คุณรับรายงานข้อขัดข้องที่ครอบคลุมได้ใน คอนโซล Firebase

ก่อนที่คุณจะเริ่ม

เพิ่ม Firebase ในโปรเจ็กต์ Android ของคุณหากยังไม่ได้ทำ หากคุณไม่มีแอป Android คุณสามารถดาวน์โหลด แอปตัวอย่าง ได้
ไม่บังคับ : หากต้องการรับเมตริกข้อขัดข้องเช่นผู้ใช้ที่ไม่มีข้อผิดพลาดเบรดครัมบ์และเหตุการณ์ที่กำหนดเองคุณจะต้องเปิดใช้งาน Google Analytics ในโครงการ Firebase ของคุณ
1. หากโครงการ Firebase ที่คุณมีอยู่ไม่ได้เปิดใช้งาน Google Analytics คุณสามารถเปิดใช้งาน Google Analytics ได้จาก แท็บ การผสานรวม ของ > การตั้งค่าโครงการ
  หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์
2. สุดท้ายในคอนโซล Google Analytics ให้เปิดใช้งานการแชร์ข้อมูลในแท็บผู้ ดูแลระบบ > การตั้งค่าบัญชี > การตั้งค่าการแชร์ข้อมูล
  สำหรับโครงการ Firebase รุ่นเก่าโปรดทราบว่าคุณอาจต้องเปิดใช้งานการแชร์ข้อมูลใน แท็บ การผสานรวม ของ > การตั้งค่าโครงการ (ในคอนโซล Firebase)

ขั้นตอนที่ 1 : ตั้งค่า Crashlytics ในคอนโซล Firebase

คลิก Crashlytics ในแผงนำทางด้านซ้ายของ คอนโซล Firebase
หากโครงการ Firebase ของคุณมีหลายแอปที่ลงทะเบียนไว้ให้เลือกแอปที่คุณเพิ่งเพิ่มจากเมนูแบบเลื่อนลงถัดจาก Crashlytics ในแถบด้านบนของคอนโซล
คลิก เปิดใช้งาน Crashlytics

ขั้นตอนที่ 2 : เพิ่ม Firebase Crashlytics ลงในแอปของคุณ

ในไฟล์ build.gradle ระดับโปรเจ็กต์ของคุณให้เพิ่มปลั๊กอิน Crashlytics Gradle เป็นการอ้างอิง buildscript

buildscript {
    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
ปรับแต่งการตั้งค่ารายงานข้อขัดข้องของคุณ โดยเพิ่มการเลือกใช้การรายงานบันทึกคีย์และการติดตามข้อผิดพลาดที่ไม่ร้ายแรง