หน้านี้ได้รับการแปลโดย Cloud Translation API

รับรายงานข้อขัดข้อง NDK ของ Android

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

คำแนะนำนี้อธิบายวิธีกำหนดค่ารายงานข้อขัดข้องด้วย Firebase Crashlytics SDK สำหรับ NDK

หากกำลังมองหาวิธีเริ่มต้นใช้งาน Crashlytics ในโปรเจ็กต์ Unity โปรดอ่านคู่มือเริ่มต้นใช้งาน Unity

ก่อนเริ่มต้น

เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้เพิ่ม หากไม่มีแอป Android คุณสามารถดาวน์โหลด แอปตัวอย่างได้
แนะนำ: หากต้องการรับบันทึกเบรดครัมบ์โดยอัตโนมัติ คุณต้องเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase เพื่อทำความเข้าใจการดำเนินการของผู้ใช้ที่นำไปสู่เหตุการณ์ข้อขัดข้อง ไม่ร้ายแรง หรือ ANR
- หากโปรเจ็กต์ Firebase ที่มีอยู่ไม่ได้เปิดใช้ Google Analytics คุณเปิดใช้ Google Analytics ได้จากแท็บการผสานรวมของ > การตั้งค่าโปรเจ็กต์ในคอนโซล Firebase
- หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้ Google Analytics ในระหว่างกระบวนการสร้างโปรเจ็กต์
ตรวจสอบว่าแอปมีเวอร์ชันขั้นต่ำที่จำเป็นต่อไปนี้
- Gradle 8.0
- ปลั๊กอิน Android Gradle 8.1.0
- ปลั๊กอิน Gradle 4.4.1 สำหรับบริการของ Google

ขั้นตอนที่ 1: เพิ่ม Crashlytics SDK สำหรับ NDK ลงในแอป

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยทั่วไปจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้เพิ่มทรัพยากร Dependency สำหรับไลบรารี Crashlytics NDK สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันไลบรารี

เราแนะนำให้เปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอปเพื่อประสบการณ์การใช้งาน Crashlytics ที่ดีที่สุด

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.1.0"))

    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics-ndk")
    implementation("com.google.firebase:firebase-analytics")
}

การใช้ Firebase Android BoM จะทำให้ แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ

(ทางเลือก) เพิ่มทรัพยากร Dependency ของไลบรารี Firebase โดยไม่ต้องใช้ BoM

หากเลือกไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดทรัพยากร Dependency

โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลายในแอป เราขอแนะนำให้ใช้ BoM ในการจัดการเวอร์ชันไลบรารีซึ่งจะดูแลให้ทุกเวอร์ชันทำงานร่วมกันได้

dependencies {
    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics-ndk:19.0.1")
    implementation("com.google.firebase:firebase-analytics:22.0.1")
}

หากกำลังมองหาโมดูลไลบรารีสำหรับ Kotlin โดยเฉพาะ ตั้งแต่ เดือนตุลาคม 2023 (Firebase BoM 32.5.0) ทั้งนักพัฒนา Kotlin และ Java จะ ขึ้นอยู่กับโมดูลไลบรารีหลัก (ดูรายละเอียดได้ที่ คําถามที่พบบ่อยเกี่ยวกับโครงการริเริ่มนี้)

ขั้นตอนที่ 2: เพิ่มปลั๊กอิน Crashlytics Gradle ลงในแอป

ในไฟล์ Gradle ระดับราก (ระดับโปรเจ็กต์) (<project>/build.gradle.kts หรือ <project>/build.gradle) ให้เพิ่มปลั๊กอิน Crashlytics Gradle ลงในบล็อก plugins ดังนี้
Kotlin
คุณยังใช้ไวยากรณ์ buildscript อยู่ไหม ดูวิธีเพิ่มปลั๊กอิน Firebase โดยใช้ไวยากรณ์ดังกล่าว
```
plugins {
    // Make sure that you have the AGP plugin 8.1+ dependency
    id("com.android.application") version "8.1.4" apply false
    // ...

    // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
    id("com.google.gms.google-services") version "4.4.2" apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id("com.google.firebase.crashlytics") version "3.0.1" apply false
}
```
Groovy
คุณยังใช้ไวยากรณ์ buildscript อยู่ไหม ดูวิธีเพิ่มปลั๊กอิน Firebase โดยใช้ไวยากรณ์ดังกล่าว
```
plugins {
    // Make sure that you have the AGP plugin 8.1+ dependency
    id 'com.android.application' version '8.1.4' apply false
    // ...

    // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
    id 'com.google.gms.google-services' version '4.4.2' apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id 'com.google.firebase.crashlytics' version '3.0.1' apply false
}
```
แอปของคุณใช้ Gradle เวอร์ชันต่ำกว่าหรือไม่ ลองอัปเกรด ไม่เช่นนั้นก็ควรใช้ปลั๊กอิน Crashlytics Gradle เวอร์ชัน 2.9.9

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยทั่วไปจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้ติดตั้งปลั๊กอิน Crashlytics Gradle ดังนี้

Kotlin

plugins {
  id("com.android.application")
  // ...

  // Make sure that you have the Google services Gradle plugin
  id("com.google.gms.google-services")

  // Add the Crashlytics Gradle plugin
  id("com.google.firebase.crashlytics")
}

Groovy

plugins {
  id 'com.android.application'
  // ...

  // Make sure that you have the Google services Gradle plugin
  id 'com.google.gms.google-services'

  // Add the Crashlytics Gradle plugin
  id 'com.google.firebase.crashlytics'
}

ขั้นตอนที่ 3: เพิ่มส่วนขยาย Crashlytics ลงในบิลด์

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยทั่วไปจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้กำหนดค่าส่วนขยาย Crashlytics

Kotlin

import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension

// ...

android {
  // ...
  buildTypes {
      getByName("release") {
          // Add this extension
          configure<CrashlyticsExtension> {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled = true
          }
      }
  }
}

Groovy

// ...

android {
  // ...
  buildTypes {
      release {
          // Add this extension
          firebaseCrashlytics {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled true
          }
      }
  }
}

ขั้นตอนที่ 4: ตั้งค่าการอัปโหลดสัญลักษณ์เนทีฟโดยอัตโนมัติ

Crashlytics จำเป็นต้องรู้เกี่ยวกับสัญลักษณ์ในไบนารีของระบบเพื่อสร้างสแต็กเทรซที่อ่านได้จากข้อขัดข้องของ NDK ปลั๊กอิน Crashlytics Gradle มีงาน uploadCrashlyticsSymbolFileBUILD_VARIANT เพื่อทำให้กระบวนการนี้เป็นไปโดยอัตโนมัติ

โปรดตรวจสอบว่าได้ตั้งค่า nativeSymbolUploadEnabled เป็น true ในไฟล์ Gradle ของโมดูล (ระดับแอป) เพื่อให้คุณเข้าถึงงานสำหรับการอัปโหลดสัญลักษณ์อัตโนมัติได้
หากต้องการให้ชื่อเมธอดปรากฏในสแต็กเทรซ คุณต้องเรียกใช้งาน uploadCrashlyticsSymbolFileBUILD_VARIANT อย่างชัดแจ้งหลังจากบิลด์แต่ละรายการของไลบรารี NDK เช่น
```
>./gradlew app:assembleBUILD_VARIANT\
           app:uploadCrashlyticsSymbolFileBUILD_VARIANT
```
ทั้ง Crashlytics SDK สำหรับ NDK และปลั๊กอิน Crashlytics Gradle ขึ้นอยู่กับการมีอยู่ของรหัสบิลด์ GNU ภายในออบเจ็กต์ที่แชร์แบบเนทีฟ

คุณยืนยันว่ามีรหัสนี้ได้โดยการเรียกใช้ readelf -n ในไบนารีแต่ละรายการ หากไม่มีรหัสบิลด์ ให้เพิ่ม -Wl,--build-id ลงในแฟล็กของระบบบิลด์เพื่อแก้ไขปัญหา

ขั้นตอนที่ 5: บังคับให้การทดสอบขัดข้องเพื่อตั้งค่าให้เสร็จสิ้น

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

เพิ่มโค้ดลงในแอปของคุณที่ใช้บังคับให้การทดสอบขัดข้องได้

คุณใช้โค้ดต่อไปนี้ใน MainActivity ของแอปเพื่อเพิ่มปุ่มลงในแอปได้ ซึ่งจะทําให้เกิดข้อขัดข้องเมื่อกดปุ่ม โดยปุ่มจะมีป้ายกำกับว่า "ทดสอบข้อขัดข้อง"

Kotlin+KTX

val crashButton = Button(this)
crashButton.text = "Test Crash"
crashButton.setOnClickListener {
   throw RuntimeException("Test Crash") // Force a crash
}

addContentView(crashButton, ViewGroup.LayoutParams(
       ViewGroup.LayoutParams.MATCH_PARENT,
       ViewGroup.LayoutParams.WRAP_CONTENT))

Java

Button crashButton = new Button(this);
crashButton.setText("Test Crash");
crashButton.setOnClickListener(new View.OnClickListener() {
   public void onClick(View view) {
       throw new RuntimeException("Test Crash"); // Force a crash
   }
});

addContentView(crashButton, new ViewGroup.LayoutParams(
       ViewGroup.LayoutParams.MATCH_PARENT,
       ViewGroup.LayoutParams.WRAP_CONTENT));

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

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

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

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

(แนะนำ) รับความช่วยเหลือในการแก้ไขข้อบกพร่องของข้อขัดข้องที่เกิดจากข้อผิดพลาดด้านหน่วยความจําของระบบโดยการรวบรวมรายงาน GWP-ASan ข้อผิดพลาดเกี่ยวกับหน่วยความจำเหล่านี้อาจเกี่ยวข้องกับความเสียหายของหน่วยความจำภายในแอป ซึ่งเป็นสาเหตุหลักของช่องโหว่ด้านความปลอดภัยของแอป หากต้องการใช้ประโยชน์จากฟีเจอร์การแก้ไขข้อบกพร่องนี้ ให้ตรวจสอบว่าแอปของคุณเปิดใช้ GWP-ASan อย่างชัดแจ้ง และใช้ Crashlytics SDK ล่าสุดสำหรับ NDK (v18.3.6 ขึ้นไป หรือ Firebase BoM v31.3.0 ขึ้นไป)
ปรับแต่งการตั้งค่ารายงานข้อขัดข้อง โดยเพิ่มการรายงานการเลือกใช้ บันทึก คีย์ และการติดตามข้อผิดพลาดที่ไม่ร้ายแรง
ผสานรวมกับ Google Play เพื่อให้คุณกรองรายงานข้อขัดข้องของแอป Android ตามแทร็ก Google Play ได้โดยตรงในแดชบอร์ด Crashlytics ซึ่งจะช่วยให้คุณมุ่งเน้นแดชบอร์ดไปยังบิลด์ที่เฉพาะเจาะจงได้ดียิ่งขึ้น

การแก้ปัญหา

หากคุณเห็นสแต็กเทรซที่ต่างกันในคอนโซล Firebase และใน Logcat โปรดดูคู่มือการแก้ปัญหา

ตัวเลือกอื่นๆ สำหรับการอัปโหลดสัญลักษณ์

เวิร์กโฟลว์หลักในหน้านี้ด้านบนใช้ได้กับบิลด์ Gradle มาตรฐาน อย่างไรก็ตาม แอปบางแอปใช้การกำหนดค่าหรือเครื่องมือที่แตกต่างกัน (เช่น กระบวนการบิลด์ที่ไม่ใช่ Gradle) ในกรณีเหล่านี้ ตัวเลือกต่อไปนี้อาจเป็นประโยชน์ ในการอัปโหลดสัญลักษณ์ให้สำเร็จ

ตัวเลือก: อัปโหลดสัญลักษณ์สำหรับโมดูลไลบรารีและทรัพยากร Dependency ภายนอก

ตัวเลือกนี้จะมีประโยชน์ในสถานการณ์ต่อไปนี้

หากคุณใช้กระบวนการบิลด์ NDK ที่กำหนดเองใน Gradle
หากไลบรารีแบบเนทีฟสร้างขึ้นในโมดูล ไลบรารี/ฟีเจอร์หรือให้บริการโดยบุคคลที่สาม
หากงานการอัปโหลดสัญลักษณ์อัตโนมัติล้มเหลวหรือคุณเห็นข้อขัดข้องที่ไม่มีสัญลักษณ์ในหน้าแดชบอร์ด

ดูวิธีการสำหรับตัวเลือกนี้

งานอัปโหลดสัญลักษณ์ Crashlytics แบบมาตรฐานจะถือว่าคุณกำลังสร้างไลบรารีเนทีฟเป็นส่วนหนึ่งของบิลด์ Gradle ของโมดูลแอป โดยใช้เครื่องมือสร้าง NDK มาตรฐาน เช่น CMake

อย่างไรก็ตาม หากคุณใช้กระบวนการบิลด์ NDK ที่กำหนดเองภายใน Gradle หรือไลบรารีในเครื่องสร้างขึ้นในโมดูลไลบรารี/ฟีเจอร์ หรือให้บริการโดยบุคคลที่สาม คุณอาจต้องระบุเส้นทางไปยังไลบรารีที่ยังไม่ได้ Strip ของคุณอย่างชัดเจน ในการดำเนินการ ให้เพิ่มพร็อพเพอร์ตี้ unstrippedNativeLibsDir ภายในส่วนขยาย Crashlytics ในไฟล์บิลด์ Gradle

โปรดตรวจสอบว่าคุณได้ทำงานเบื้องต้นต่อไปนี้จากเวิร์กโฟลว์หลักในหน้า "นี้" แล้ว
เพื่อให้งานการอัปโหลดสัญลักษณ์อัตโนมัติค้นหาข้อมูลสัญลักษณ์ของคุณได้ ให้เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ Gradle แบบโมดูล (ระดับแอป) (โดยปกติจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle)
Kotlin
```
import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension

// ...

android {
    // ...
    buildTypes {
        release {
            configure<CrashlyticsExtension> {
                nativeSymbolUploadEnabled = true
                unstrippedNativeLibsDir = file("PATH/TO/UNSTRIPPED/DIRECTORY")
            }
        }
    }
}
```
Groovy
```
// ...

android {
    // ...
    buildTypes {
        release {
            firebaseCrashlytics {
                nativeSymbolUploadEnabled true
                unstrippedNativeLibsDir file("PATH/TO/UNSTRIPPED/DIRECTORY")
            }
        }
    }
}
```
ปลั๊กอิน Crashlytics จะค้นหาไดเรกทอรีที่ระบุซ้ำเพื่อดูไลบรารีเนทีฟที่มีส่วนขยาย .so จากนั้น Crashlytics จะแยกสัญลักษณ์การแก้ไขข้อบกพร่องจากไลบรารีดังกล่าวทั้งหมดและอัปโหลดไปยังเซิร์ฟเวอร์ Firebase

สิ่งที่คุณระบุในพร็อพเพอร์ตี้ unstrippedNativeLibsDir ได้มีดังนี้
- อาร์กิวเมนต์ที่อนุญาตสำหรับ org.gradle.api.Project#files(Object...) รวมถึง java.lang.String, java.io.File หรือ org.gradle.api.file.FileCollection
- หลายไดเรกทอรีสำหรับเวอร์ชันบิลด์เดียวด้วยการระบุรายการหรืออินสแตนซ์ FileCollection
- (เริ่มต้นด้วยปลั๊กอิน Crashlytics Gradle v3.0.0) รวบรวมหลายไดเรกทอรีในผลิตภัณฑ์แต่ละรายการและสร้างเวอร์ชันต่างๆ
ดูตัวอย่างที่มีหลายไดเรกทอรี
```
  buildTypes {
    release {
      configure<CrashlyticsExtension> {
        nativeSymbolUploadEnabled = true
        unstrippedNativeLibsDir = file("MY/NATIVE/LIBS")
      }
    }
    productFlavors {
      flavorDimensions += "feature"
      create("basic") {
        dimension = "feature"
        // ...
      }
      create("featureX") {
        dimension = "feature"
        configure<CrashlyticsExtension> {
          unstrippedNativeLibsDir = file("MY/FEATURE_X/LIBS")
        }
      }
    }
  }
  
```
งาน uploadCrashlyticsSymbolFilesBasicRelease จะอัปโหลดสัญลักษณ์ใน MY/NATIVE/LIBS เท่านั้น แต่ uploadCrashlyticsSymbolFilesFeatureXRelease จะอัปโหลดสัญลักษณ์ทั้งใน MY/NATIVE/LIBS และ MY/FEATURE_X/LIBS
สุดท้าย ให้บังคับให้ทดสอบข้อขัดข้องเพื่อตั้งค่า Crashlytics ให้เสร็จสิ้นและดูข้อมูลเบื้องต้นในแดชบอร์ด Crashlytics ของคอนโซล Firebase

ตัวเลือก: อัปโหลดสัญลักษณ์สำหรับบิลด์ที่ไม่ใช่ Gradle หรือไลบรารีเนทีฟที่ไม่ได้ Strip เข้าซึ่งเข้าถึงไม่ได้

ตัวเลือกนี้จะมีประโยชน์ในสถานการณ์ต่อไปนี้

หากใช้กระบวนการบิลด์ที่ไม่ใช่ Gradle
หากระบบส่งไลบรารีเนทีฟที่ไม่ได้ Strip ให้คุณในลักษณะที่เข้าถึงไม่ได้ระหว่างบิลด์ Gradle

ดูวิธีการสำหรับตัวเลือกนี้

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

โปรดตรวจสอบว่าคุณได้ทำงานเบื้องต้นต่อไปนี้จากเวิร์กโฟลว์หลักในหน้า "นี้" แล้ว
1. เปิดใช้ Crashlytics ในคอนโซล Firebase แล้ว
2. เพิ่ม Crashlytics SDK สำหรับ NDK และปลั๊กอิน Crashlytics Gradle
โปรดทราบว่าเมื่อใช้ตัวเลือกนี้ คุณไม่จำเป็นต้องเพิ่มส่วนขยาย firebaseCrashlytics หรือตั้งค่าการอัปโหลดสัญลักษณ์อัตโนมัติ เนื่องจากคุณจะต้องใช้ Firebase CLI (ขั้นตอนถัดไปด้านล่าง) เพื่อสร้างและอัปโหลดไฟล์สัญลักษณ์แทน
ตั้งค่าสภาพแวดล้อมและโปรเจ็กต์สำหรับการอัปโหลดสัญลักษณ์
1. ทำตามวิธีการเพื่อติดตั้ง Firebase CLI
  
  หากคุณติดตั้ง CLI ไว้แล้ว ให้ตรวจสอบว่าได้อัปเดตเป็นเวอร์ชันล่าสุดแล้ว
2. (สำหรับแอปที่ใช้ Android API ระดับ 30 ขึ้นไปเท่านั้น) อัปเดตเทมเพลต AndroidManifest.xml ของแอปเพื่อปิดใช้การแท็กเคอร์เซอร์ ดังนี้
  1. ทำเครื่องหมายในช่องการตั้งค่าโปรแกรมเล่น Android > การตั้งค่าการเผยแพร่ > สร้าง > ไฟล์ Manifest หลักที่กำหนดเอง
  2. เปิดเทมเพลตไฟล์ Manifest ซึ่งอยู่ที่ Assets/Plugins/Android/AndroidManifest.xml
  3. เพิ่มแอตทริบิวต์ต่อไปนี้ลงในแท็กแอปพลิเคชัน <application android:allowNativeHeapPointerTagging="false" ... />
สร้างโปรเจ็กต์

อัปโหลดข้อมูลสัญลักษณ์

เมื่อสร้างเสร็จแล้ว ให้สร้างไฟล์สัญลักษณ์ที่เข้ากันได้กับ 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 จะเป็นไดเรกทอรีใดก็ได้ Firebase CLI จะค้นหาไดเรกทอรีที่ระบุซ้ำเพื่อดูไลบรารีเนทีฟที่มีส่วนขยาย .so
- สร้าง 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`	ให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม

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

หลังจากที่สร้างแอปซึ่งเป็นส่วนหนึ่งของการบังคับให้เกิดข้อขัดข้อง ให้เรียกใช้คำสั่ง Firebase CLI crashlytics:symbols:upload เพื่ออัปโหลดไฟล์สัญลักษณ์