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

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

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

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

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

แพลตฟอร์มของ Apple

ตรวจสอบการกำหนดค่าสำหรับการอัปโหลดไฟล์ dSYM

การเพิ่มCrashlyticsปลั๊กอิน Flutter และการเรียกใช้คำสั่ง flutterfire configure จะพยายามเพิ่มสคริปต์การเรียกใช้ลงในพื้นที่ทํางาน Xcode ของโปรเจ็กต์ ซึ่งจะค้นหาและอัปโหลดไฟล์สัญลักษณ์ dSYM ที่จําเป็นไปยัง Crashlytics หากไม่มีไฟล์เหล่านี้ คุณจะเห็นการแจ้งเตือน "dSYM ขาดหายไป" ใน แดชบอร์ด Crashlytics และแบ็กเอนด์จะระงับข้อยกเว้นไว้จนกว่า จะมีการอัปโหลดไฟล์ที่ขาดหายไป

หากพบปัญหานี้ ให้ตรวจสอบก่อนว่าคุณได้ติดตั้งสคริปต์ที่เรียกใช้แล้วหรือไม่ โดยทำดังนี้

ค้นหาและเปิดไฟล์พื้นที่ทํางาน Xcode ในไดเรกทอรี iOS ของโปรเจ็กต์ (FLUTTER_PROJECT_NAME/ios/Runner.xcworkspace)
ระบุว่าได้เพิ่มสคริปต์ที่เรียกใช้ชื่อ [firebase_crashlytics] Crashlytics Upload Symbols ลงใน Build Phases ของเป้าหมาย Runner หรือไม่

ดูส่วนที่เกี่ยวข้องด้านล่างเพื่อดูว่าไม่มีสคริปต์ที่เรียกใช้หรือ มีสคริปต์ที่เรียกใช้

ไม่มีสคริปต์สำหรับการอัปโหลด dSYM โดยอัตโนมัติ

หากไม่มีสคริปต์ที่เรียกใช้ดังกล่าว คุณสามารถเพิ่มด้วยตนเองได้โดยทำดังนี้

หารหัสแอป Firebase สำหรับแอป Apple โดยคุณจะดูรหัสนี้ได้จาก 2 ที่ต่อไปนี้
- ในFirebase Console ให้ไปที่ > การตั้งค่าโปรเจ็กต์ ไปที่การ์ดแอปของคุณ แล้วคลิกแอป Firebase ของ Apple เพื่อดูข้อมูลของแอป รวมถึงรหัสแอป
- ในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Flutter ให้ค้นหาไฟล์ firebase_options.dart รหัสแอป Firebase สำหรับแอป Apple ของคุณมีป้ายกำกับว่า appId
คลิก > New Run Script Phase

ตรวจสอบว่าเฟส Run Script ใหม่นี้เป็นเฟสการสร้างสุดท้ายของโปรเจ็กต์ มิฉะนั้น Crashlytics จะประมวลผล dSYM อย่างถูกต้องไม่ได้
ขยายส่วนเรียกใช้สคริปต์ใหม่

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

สคริปต์เหล่านี้จะประมวลผลไฟล์ dSYM และอัปโหลดไฟล์ไปยัง Crashlytics
```
$PODS_ROOT/FirebaseCrashlytics/upload-symbols --build-phase --validate -ai FIREBASE_APP_ID -- $DWARF_DSYM_FOLDER_PATH/App.framework.dSYM
```
```
$PODS_ROOT/FirebaseCrashlytics/upload-symbols --build-phase -ai FIREBASE_APP_ID -- $DWARF_DSYM_FOLDER_PATH/App.framework.dSYM 
```
- FIREBASE_APP_ID: รหัสแอป Apple ของ Firebase (ไม่ใช่รหัสชุด Apple)
  ตัวอย่างรหัสแอป Apple ของ Firebase: 1:1234567890:ios:321abc456def7890
หากต้องการหารหัสแอป Firebase
วิธีหารหัสแอป Firebase มี 2 วิธีดังนี้
- ในไฟล์ GoogleService-Info.plist รหัสแอปคือค่า GOOGLE_APP_ID หรือ
- ในFirebaseคอนโซล ให้ไปที่การตั้งค่าโปรเจ็กต์ ไปที่การ์ดแอปของคุณ แล้วคลิกแอป Firebase ที่ต้องการ เพื่อค้นหารหัสแอป
ในส่วนไฟล์อินพุต ให้เพิ่มเส้นทางไปยังตำแหน่งของไฟล์ต่อไปนี้
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
```
```
$(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
```
```
$(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)
```
ทำความเข้าใจเหตุผลที่ต้องทราบตำแหน่งของไฟล์เหล่านี้

Xcode จะค้นหาไฟล์อินพุตเหล่านี้ในตำแหน่งที่ระบุเพื่อให้แน่ใจว่า ไฟล์บิลด์พร้อมใช้งานสำหรับสคริปต์การเรียกใช้ นอกจากนี้ หากเปิดใช้แซนด์บ็อกซ์ของสคริปต์ผู้ใช้ Xcode จะอนุญาตให้สคริปต์รันเข้าถึงไฟล์ที่ระบุในไฟล์อินพุตเท่านั้น
- การระบุตำแหน่งของไฟล์ dSYM ของโปรเจ็กต์จะช่วยให้ Crashlytics ประมวลผล dSYM ได้
- การระบุตำแหน่งของไฟล์ที่สร้างขึ้นของแอป GoogleService-Info.plist ช่วยให้ Crashlytics เชื่อมโยง dSYM กับแอป Firebase ของคุณได้
- การระบุตำแหน่งของไฟล์ที่เรียกใช้งานได้ของแอปจะช่วยให้สคริปต์ run ป้องกันการอัปโหลด dSYM เดียวกันซ้ำ โปรดทราบว่าระบบจะไม่อัปโหลดไบนารีของแอป

เรียกใช้สคริปต์สำหรับการอัปโหลด dSYM อัตโนมัติ

หากมีสคริปต์ที่เรียกใช้ โปรดดูคำแนะนำเฉพาะของ Apple สำหรับการแก้ปัญหา dSYM คุณจะต้องทำตามขั้นตอนเพิ่มเติมต่อไปนี้หากเลือกอัปโหลดไฟล์ dSYM ผ่านกระบวนการที่อธิบายไว้

หารหัสแอป Firebase สำหรับแอป Apple โดยคุณจะดูรหัสนี้ได้จาก 2 ที่ต่อไปนี้
- ในFirebase Console ให้ไปที่ > การตั้งค่าโปรเจ็กต์ ไปที่การ์ดแอปของคุณ แล้วคลิกแอป Firebase ของ Apple เพื่อดูข้อมูลของแอป รวมถึงรหัสแอป
- ในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Flutter ให้ค้นหาไฟล์ firebase_options.dart รหัสแอป Firebase สำหรับแอป Apple ของคุณมีป้ายกำกับว่า appId
เมื่อเรียกใช้สคริปต์ upload-symbols ให้ใช้ -ai FIREBASE_APPLE_APP_ID แทน -gsp /path/to/GoogleService-Info.plist

ตรวจสอบการกำหนดค่าเวอร์ชันสำหรับ Flutter และ Crashlytics (หากใช้ Flag `--split-debug-info`)

หากโปรเจ็กต์ Flutter ใช้แฟล็ก --split-debug-info (และอาจใช้แฟล็ก --obfuscate ด้วย) คุณจะต้องทำตามขั้นตอนเพิ่มเติมเพื่อแสดง Stack Trace ที่อ่านได้สำหรับแอป

ตรวจสอบว่าโปรเจ็กต์ของคุณใช้การกำหนดค่าเวอร์ชันที่แนะนำ (Flutter 3.12.0 ขึ้นไปและCrashlyticsปลั๊กอิน Flutter 3.3.4 ขึ้นไป) เพื่อให้โปรเจ็กต์ สร้างและอัปโหลดสัญลักษณ์ Flutter (ไฟล์ dSYM) ไปยัง Crashlyticsได้โดยอัตโนมัติ

Android

ตรวจสอบการกำหนดค่าการขึ้นต่อกัน

คำสั่ง flutterfire configure จะพยายามเพิ่มทรัพยากร Dependency ที่จำเป็นลงใน ไฟล์บิลด์ Gradle ของโปรเจ็กต์ หากไม่มีการอ้างอิงเหล่านี้ รายงานข้อขัดข้องในFirebaseคอนโซลอาจถูกปกปิดหากเปิดการปกปิดไว้

ตรวจสอบว่ามีบรรทัดต่อไปนี้ใน build.gradle ระดับโปรเจ็กต์ และใน build.gradle ระดับแอป

ในไฟล์บิลด์ระดับโปรเจ็กต์ (android/build.gradle) ให้ตรวจสอบบรรทัดต่อไปนี้
```
dependencies {
// ... other dependencies

classpath 'com.google.gms:google-services:4.3.5'
classpath 'com.google.firebase:firebase-crashlytics-gradle:2.7.1'
}
```

ในไฟล์บิลด์ระดับแอป (android/app/build.gradle) ให้ตรวจสอบบรรทัดต่อไปนี้

// ... other imports

android {
// ... your android config
}

dependencies {
// ... your dependencies
}

// This section must appear at the bottom of the file
apply plugin: 'com.google.gms.google-services'
apply plugin: 'com.google.firebase.crashlytics'

ตรวจสอบว่าคุณใช้ CLI เพื่ออัปโหลดสัญลักษณ์ Flutter (หากใช้แฟล็ก `--split-debug-info`)

ใช้ Firebase CLI (v.11.9.0 ขึ้นไป) เพื่ออัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่องของ Flutter คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่องก่อนรายงานข้อขัดข้องจากบิลด์โค้ดที่ผ่านการปรับให้ยากต่อการอ่าน (Obfuscate)

จากไดเรกทอรีรากของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้

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: ไดเรกทอรีเดียวกันกับที่คุณ ส่งไปยังแฟล็ก --split-debug-info เมื่อสร้างแอปพลิเคชัน

หากยังพบปัญหา โปรดดูคำแนะนำเฉพาะสำหรับ Android ในการแก้ปัญหาเกี่ยวกับรายงานที่ผ่านการปกปิด