รับรายงานข้อขัดข้องที่อ่านได้ในแดชบอร์ด Crashlytics (Unity)

เลือกแพลตฟอร์ม:

iOS+ Android Flutter Unity

เราขอแนะนำให้ใช้ Crashlytics Unity SDK เวอร์ชันล่าสุด (v13.13.0) ดาวน์โหลดเวอร์ชันล่าสุด

iOS+ (แพลตฟอร์มของ Apple)

สำหรับแอปบนแพลตฟอร์มของ Apple ที่ใช้ Crashlytics Unity SDK 8.2.0 ขึ้นไป ปลั๊กอิน Firebase Unity Editor จะกำหนดค่าโปรเจ็กต์ Xcode โดยอัตโนมัติเพื่ออัปโหลด สัญลักษณ์ ดาวน์โหลดเวอร์ชันล่าสุด

Android

สำหรับแอป Android, Crashlytics Unity SDK 8.6.1 ขึ้นไปจะรวม การรายงานข้อขัดข้องของ NDK ไว้โดยอัตโนมัติ ซึ่งช่วยให้ Crashlytics รายงานข้อขัดข้องของ Unity IL2CPP ใน Android ได้โดยอัตโนมัติ อย่างไรก็ตาม หากต้องการดู Stack Trace ที่มีสัญลักษณ์สำหรับไลบรารีเนทีฟ ข้อขัดข้องในแดชบอร์ด Crashlytics คุณต้องอัปโหลดข้อมูลสัญลักษณ์ ในเวลาที่สร้างโดยใช้ CLI Firebase

1. ตรวจสอบว่าคุณใช้ Crashlytics Unity SDK v8.6.1 ขึ้นไป ดาวน์โหลดเวอร์ชันล่าสุด

2. ตั้งค่าสภาพแวดล้อมและโปรเจ็กต์สำหรับการอัปโหลดสัญลักษณ์โดยทำดังนี้

   1. ทำตามวิธีการเพื่อ ติดตั้ง Firebase CLI

      หากติดตั้ง CLI ไว้แล้ว ให้ตรวจสอบว่าได้ อัปเดตเป็นเวอร์ชันล่าสุด

      หมายเหตุ: คุณยังเรียกใช้คำสั่ง Firebase CLI ใน Cloud Shell ได้ด้วย Cloud Shell เป็นสภาพแวดล้อมบรรทัดคำสั่งที่ทำงานในเบราว์เซอร์และมีการตรวจสอบสิทธิ์ล่วงหน้า ซึ่งเข้าถึงได้จากคอนโซล Firebase และมาพร้อมกับ Firebase CLI ที่ติดตั้งไว้ล่วงหน้า จึงเป็นตัวเลือกที่สะดวกสำหรับการเริ่มต้นใช้งานอย่างรวดเร็ว เพียงแค่คุณเพิ่มไฟล์โปรเจ็กต์ลงในสภาพแวดล้อม
      Cloud Shell

   2. (เฉพาะสำหรับแอปที่ใช้ Android API ระดับ 30 ขึ้นไป) อัปเดตเทมเพลต AndroidManifest.xml ของแอปเพื่อปิดใช้การติดแท็กตัวชี้โดยทำดังนี้

      1. เลือกช่องทำเครื่องหมายการตั้งค่าเครื่องเล่น Android > การตั้งค่าการเผยแพร่ > สร้าง > ไฟล์ Manifest หลักที่กำหนดเอง

      2. เปิดเทมเพลตไฟล์ Manifest ที่อยู่ใน Assets/Plugins/Android/AndroidManifest.xml

      3. (เฉพาะสำหรับแอปที่ใช้ SDK เวอร์ชันก่อน 8.8.0) เพิ่มแอตทริบิวต์ต่อไปนี้ลงในแท็กแอปพลิเคชัน: <application android:allowNativeHeapPointerTagging="false" ... />

3. สร้างโปรเจ็กต์และอัปโหลดสัญลักษณ์

   ทำตามขั้นตอนเหล่านี้ทุกครั้งที่สร้างบิลด์รุ่นที่เผยแพร่หรือบิลด์ใดก็ตาม ที่คุณต้องการดู Stack Trace ที่มีสัญลักษณ์ใน Crashlytics แดชบอร์ด

   1. จากกล่องโต้ตอบ Build Settings ให้ทำอย่างใดอย่างหนึ่งต่อไปนี้

      • ส่งออกไปยังโปรเจ็กต์ Android Studio เพื่อสร้างโปรเจ็กต์ หรือ

      • สร้าง APK จาก Unity Editor โดยตรง
        ก่อนสร้าง ให้ตรวจสอบว่าได้เลือกช่องทำเครื่องหมายสร้าง symbols.zip ในกล่องโต้ตอบ Build Settings

   2. เมื่อสร้างเสร็จแล้ว ให้สร้างไฟล์สัญลักษณ์ที่เข้ากันได้กับ Crashlytics แล้วอัปโหลดไปยังเซิร์ฟเวอร์ Firebase โดยเรียกใช้คำสั่ง Firebase CLI ต่อไปนี้

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: รหัสแอป Firebase Android (ไม่ใช่ ชื่อแพ็กเกจ)
        ตัวอย่างรหัสแอป Firebase Android: 1:567383003300:android:17104a2ced0c9b9b

        ต้องการค้นหารหัสแอป Firebase ใช่ไหม

        คุณค้นหารหัสแอป Firebase ได้ 2 วิธีดังนี้

        • ในไฟล์ google-services.json รหัสแอปคือค่า mobilesdk_app_id หรือ

        • ในคอนโซล Firebase ให้ไปที่หน้า การตั้งค่า > ทั่วไป เลื่อนไปที่การ์ดแอปของคุณ แล้วคลิกแอป Firebase ที่ต้องการเพื่อค้นหารหัสแอป

      • PATH/TO/SYMBOLS: เส้นทางไปยังไฟล์สัญลักษณ์ที่ CLI สร้างขึ้น

        • ส่งออกไปยังโปรเจ็กต์ Android Studio — PATH/TO/SYMBOLS คือไดเรกทอรีunityLibrary/symbols ซึ่งสร้างขึ้นในรูทของโปรเจ็กต์ที่ส่งออกหลังจากที่คุณสร้างแอป ผ่าน Gradle หรือ Android Studio

        • สร้าง APK จากภายใน Unity โดยตรง — PATH/TO/SYMBOLS คือเส้นทางของไฟล์สัญลักษณ์ที่บีบอัด ซึ่งสร้างขึ้นในไดเรกทอรีรูทของโปรเจ็กต์เมื่อสร้างเสร็จแล้ว (เช่น: myproject/myapp-1.0-v100.symbols.zip)

      ดูตัวเลือกขั้นสูงสำหรับการใช้ Firebase คำสั่ง CLI เพื่อสร้างและอัปโหลดไฟล์สัญลักษณ์

      แฟล็ก	คำอธิบาย
      --generator=csym	ใช้เครื่องมือสร้างไฟล์สัญลักษณ์ cSYM แบบเดิมแทน เครื่องมือสร้าง Breakpad เริ่มต้น ไม่แนะนำให้ใช้ เราขอแนะนำให้ใช้เครื่องมือสร้างไฟล์สัญลักษณ์ Breakpad เริ่มต้น
      --generator=breakpad	ใช้เครื่องมือสร้างไฟล์สัญลักษณ์ Breakpad โปรดทราบว่าค่าเริ่มต้นสำหรับการสร้างไฟล์สัญลักษณ์คือ Breakpad ใช้แฟล็กนี้เฉพาะในกรณีที่คุณเพิ่ม symbolGenerator { csym() } ในการกำหนดค่าบิลด์และต้องการลบล้างเพื่อใช้ Breakpad แทน
      --dry-run	สร้างไฟล์สัญลักษณ์แต่ไม่อัปโหลด แฟล็กนี้มีประโยชน์หากคุณต้องการตรวจสอบเนื้อหาของ ไฟล์ที่จะส่ง
      --debug	ให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม