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

iOS Android Flutter Unity

เราขอแนะนำให้ใช้ Crashlytics เวอร์ชันล่าสุด Unity SDK (v12.1.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 แต่หากต้องการดูสแต็กเทรซที่แทนที่ด้วยสัญลักษณ์สำหรับไลบรารีเนทีฟ ขัดข้องในหน้าแดชบอร์ด Crashlytics คุณต้องอัปโหลดข้อมูลสัญลักษณ์ที่ เวลาบิลด์โดยใช้ Firebase CLI

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

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

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

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

   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. สร้างโปรเจ็กต์และอัปโหลดสัญลักษณ์

   ทำตามขั้นตอนเหล่านี้ทุกครั้งที่สร้างบิลด์รุ่นหรือบิลด์ใดก็ตาม ที่คุณต้องการดูสแต็กเทรซที่แทนที่ด้วยสัญลักษณ์ในส่วน คอนโซล Firebase

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

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

      • สร้าง APK โดยตรงจาก Unity Editor
        ก่อนสร้าง โปรดตรวจสอบว่าช่องทำเครื่องหมาย Create tags.zip เลือกในกล่องโต้ตอบการตั้งค่าบิลด์

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

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

      • FIREBASE_APP_ID: รหัสแอป Android ใน Firebase (ไม่ใช่ ชื่อแพ็กเกจ)
        ตัวอย่างรหัสแอป Android ใน Firebase: 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() } ในการกำหนดค่าบิลด์ และต้องการลบล้างใช้ เบรกแพดแทน
      --dry-run	สร้างไฟล์สัญลักษณ์แต่ไม่ได้อัปโหลดไฟล์เหล่านั้น การตั้งค่าสถานะนี้มีประโยชน์หากคุณต้องการตรวจสอบเนื้อหาใน ไฟล์ที่ส่งออกแล้ว
      --debug	ให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม