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

เริ่มต้นใช้งาน Crashlytics สำหรับ Android NDK

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

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

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

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

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

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

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

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

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.6.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 เวอร์ชันที่เข้ากันได้อยู่เสมอ

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

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

โปรดทราบว่าหากคุณใช้ไลบรารี 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:20.0.3")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

ขั้นตอนที่ 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.4" apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id("com.google.firebase.crashlytics") version "3.0.6" 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.4' apply false

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

ในไฟล์ 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: ตั้งค่าการอัปโหลดสัญลักษณ์ดั้งเดิมโดยอัตโนมัติ

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

เพื่อให้คุณเข้าถึงงานสำหรับการอัปโหลดสัญลักษณ์อัตโนมัติได้ โปรดตรวจสอบว่าได้ตั้งค่า nativeSymbolUploadEnabled เป็น true ในไฟล์ Gradle ของโมดูล (ระดับแอป)
หากต้องการให้ชื่อเมธอดปรากฏใน Stack Trace คุณต้องเรียกใช้ 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

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 ซึ่งจะช่วยให้คุณมุ่งเน้นแดชบอร์ดไปที่บิลด์ที่เฉพาะเจาะจงได้ดียิ่งขึ้น

การแก้ปัญหา

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

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

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

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

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

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

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

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

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

ตรวจสอบว่าคุณได้ดำเนินการตามงานเริ่มต้นต่อไปนี้จากเวิร์กโฟลว์หลัก ที่ด้านบนของหน้านี้แล้ว
1. เปิดใช้ Crashlytics ในคอนโซล Firebase
2. เพิ่ม SDK Crashlytics สำหรับ NDK และปลั๊กอิน Gradle Crashlytics
3. เพิ่มส่วนขยาย Crashlytics ลงในการสร้างแล้ว
4. ตั้งค่าการอัปโหลดสัญลักษณ์ดั้งเดิมโดยอัตโนมัติ
เพื่อให้งานการอัปโหลดสัญลักษณ์อัตโนมัติค้นหาข้อมูลสัญลักษณ์ได้ ให้เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ 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
- ไดเรกทอรีหลายรายการสำหรับ Build Flavor เดียวโดยระบุรายการหรืออินสแตนซ์ FileCollection
- (เริ่มตั้งแต่ปลั๊กอิน Gradle v3.0.0) สะสมไดเรกทอรีหลายรายการ ในผลิตภัณฑ์และบิลด์ Flavor แต่ละรายการCrashlytics
ดูตัวอย่างที่มีหลายไดเรกทอรี
```
  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 หรือไลบรารีแบบเนทีฟที่ไม่ได้ลบข้อมูลออกซึ่งเข้าถึงไม่ได้

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

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

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

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

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

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 เพื่ออัปโหลดไฟล์ สัญลักษณ์