Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

เริ่มต้นใช้งาน Firebase Crashlytics

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

การตั้งค่า Crashlytics ต้องการงานทั้งในคอนโซล Firebase และ IDE ของคุณ (เช่น การเพิ่มไฟล์การกำหนดค่า Firebase และ Crashlytics SDK) ในการตั้งค่าให้เสร็จสิ้น คุณจะต้องบังคับให้การทดสอบขัดข้องเพื่อส่งรายงานข้อขัดข้องครั้งแรกไปยัง Firebase

ก่อนจะเริ่ม

  1. หากคุณยังไม่ได้ เพิ่ม Firebase กับโครงการความสามัคคีของคุณ หากคุณไม่ได้มีโครงการเอกภาพคุณสามารถดาวน์โหลด แอปพลิเคตัวอย่าง

  2. แนะนำ: เพื่อให้ได้คุณสมบัติเช่นผู้ใช้ความผิดพลาดของฟรี, บันทึกการแสดงเส้นทางและการแจ้งเตือนความเร็วคุณต้องเปิดการใช้งาน Google Analytics ในโครงการ Firebase ของคุณ

    • หากโครงการ Firebase มีอยู่ของคุณไม่ได้เปิดใช้ Google Analytics คุณสามารถเปิดใช้งาน Google Analytics จาก Integrations แท็บ ที่คุณ > การตั้งค่าโครงการในคอนโซล Firebase

    • หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้ Google Analytics ระหว่างเวิร์กโฟลว์การสร้างโปรเจ็กต์

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

  1. ไปที่ แผงควบคุม Crashlytics ในคอนโซล Firebase

  2. ให้แน่ใจว่าแอปของคุณถูกเลือกจากแบบเลื่อนลงถัด Crashlytics ที่ด้านบนของหน้า

  3. คลิกเปิดใช้งาน Crashlytics

ขั้นตอนที่ 2: เพิ่ม Firebase Crashlytics SDK เพื่อ app ของคุณ

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

  1. ดาวน์โหลด Firebase สามัคคี SDK แล้วเปิดเครื่องรูด SDK สะดวกที่ไหนสักแห่ง

    Firebase Unity SDK ไม่ใช่เฉพาะแพลตฟอร์ม

  2. ในโครงการของคุณเปิดสามัคคีนำทางไปยังสินทรัพย์> นำเข้าแพคเกจ> แพคเกจที่กำหนดเอง

  3. จาก SDK ซิปเลือกที่จะนำเข้า Crashlytics SDK ( FirebaseCrashlytics.unitypackage )

    คุณสามารถนำเข้าอื่น ๆ สินค้า Firebase ได้รับการสนับสนุน เป็นอย่างดี

  4. ในหน้าต่างนำเข้าสามัคคีแพคเกจคลิกนำเข้า

ขั้นตอนที่ 3: เริ่มต้น Crashlytics

  1. สร้างใหม่ C # สคริปต์แล้วเพิ่มไปยัง GameObject ในฉาก

    1. เปิดฉากแรกของคุณแล้วสร้างที่ว่างเปล่า GameObject ชื่อ CrashlyticsInitializer

    2. คลิกเพิ่มตัวแทนในการตรวจสอบสำหรับวัตถุใหม่

    3. เลือกของคุณ CrashlyticsInit สคริปต์เพื่อเพิ่มไปยัง CrashlyticsInitializer วัตถุ

  2. เตรียม Crashlytics ในสคริปต์ Start วิธีการ:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

ขั้นตอนที่ 4: การเรียกใช้โครงการของคุณ

  1. ส่งออกโครงการของคุณไปยัง iOS หรือ Android

  2. หลังจากการส่งออกเสร็จสมบูรณ์ ให้ตรวจสอบว่าโปรเจ็กต์ส่งออกอย่างถูกต้องโดยเปรียบเทียบโปรเจ็กต์ที่ส่งออกของคุณกับการกำหนดค่าการส่งออกตัวอย่างด้านล่าง

    iOS

    Android

  3. หากดูเหมือนว่าไฟล์จะหายไปหลังจากเปรียบเทียบโครงการของคุณ: เปิด Unity Editor จากนั้นเรียกใช้ Google Play Services Resolver (ดูคำแนะนำด้านล่าง)

(ตามความจำเป็น) เรียกจำแนกหากไฟล์หายไปหลังจากที่การส่งออก

ตัวแก้ไขบริการ Google Play ตรวจสอบให้แน่ใจว่าโปรเจ็กต์ Unity ของคุณมีการพึ่งพาที่เหมาะสมสำหรับการส่งออกแอปของคุณไปยัง iOS หรือ Android สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการจำแนกแวะ README สำหรับ Jar Resolver สามัคคี

ขั้นตอนที่ 5: บังคับความผิดพลาดของการทดสอบที่จะเสร็จสิ้นการติดตั้ง

หากต้องการตั้งค่า Crashlytics ให้เสร็จสิ้นและดูข้อมูลเบื้องต้นในแดชบอร์ด Crashlytics ของคอนโซล Firebase คุณต้องบังคับให้มีการทดสอบขัดข้อง

  1. ค้นหาที่มีอยู่ GameObject แล้วเพิ่มไปสคริปต์ต่อไปนี้ สคริปต์นี้จะทำให้การทดสอบขัดข้องในไม่กี่วินาทีหลังจากที่คุณเรียกใช้แอป

    using System;
    using UnityEngine;
    
    public class CrashlyticsTester : MonoBehaviour {
    
        int updatesBeforeException;
    
        // Use this for initialization
        void Start () {
          updatesBeforeException = 0;
        }
    
        // Update is called once per frame
        void Update()
        {
            // Call the exception-throwing method here so that it's run
            // every frame update
            throwExceptionEvery60Updates();
        }
    
        // A method that tests your Crashlytics implementation by throwing an
        // exception every 60 frame updates. You should see non-fatal errors in the
        // Firebase console a few minutes after running your app with this method.
        void throwExceptionEvery60Updates()
        {
            if (updatesBeforeException > 0)
            {
                updatesBeforeException--;
            }
            else
            {
                // Set the counter to 60 updates
                updatesBeforeException = 60;
    
                // Throw an exception to test your Crashlytics implementation
                throw new System.Exception("test exception please ignore");
            }
        }
    }
    
  2. สร้างและเรียกใช้แอปของคุณ

  3. เมื่อแอปของคุณกำลังทำงาน, ดูบันทึกอุปกรณ์และรอข้อยกเว้นที่จะเรียกจาก CrashlyticsTester

    • iOS: ดูบันทึกในบานหน้าต่างด้านล่างของ Xcode

    • Android: ดูบันทึกโดยใช้คำสั่งต่อไปนี้ในขั้ว: adb logcat

  4. เมื่อคุณเห็นข้อยกเว้นในบันทึกอุปกรณ์ ให้รีสตาร์ทแอปเพื่อส่งรายงานข้อขัดข้องไปยัง Firebase

  5. ไปที่ แผงควบคุม Crashlytics ของคอนโซล Firebase เพื่อดูความผิดพลาดของการทดสอบของคุณ

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


และนั่นแหล่ะ! Crashlytics กำลังตรวจสอบแอปของคุณเพื่อหาข้อขัดข้อง และคุณสามารถดูและตรวจสอบรายงานข้อขัดข้องและสถิติในแดชบอร์ด Crashlytics

ขั้นตอนถัดไป