Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

在 Crashlytics 資訊主頁中取得淺顯易懂的當機報告 (Flutter)

選取平台：

根據預設，Firebase Crashlytics 會自動檢測 Flutter 專案，上傳必要的符號檔案，確保當機回報已去模糊化，且可供人類閱讀。

不過，有時專案可能無法完整設定。本指南將概述自動化作業的功能，並提供偵錯專案設定的第一步。

Apple 平台

檢查上傳 dSYM 檔案的設定

新增 Crashlytics Flutter 外掛程式並執行 flutterfire configure 指令後，系統會嘗試在專案的 Xcode 工作區中新增執行指令碼，找出必要的 dSYM 符號檔案並上傳至 Crashlytics。如果沒有這些檔案，Crashlytics 資訊主頁會顯示「缺少 dSYM」快訊，且後端會保留例外狀況，直到上傳缺少的檔案為止。

如果遇到這個問題，請先確認您已安裝執行指令碼：

在專案的 iOS 目錄 (FLUTTER_PROJECT_NAME/ios/Runner.xcworkspace) 中，找出並開啟 Xcode 工作區檔案。
確認 Runner 目標的建構階段是否已新增名為 [firebase_crashlytics] Crashlytics Upload Symbols 的執行指令碼。

請參閱下方適用章節，瞭解執行指令碼不存在或執行指令碼存在的情況。

沒有自動上傳 dSYM 的執行指令碼

如果沒有這個執行指令碼，可以手動新增：

找出 Apple 應用程式的 Firebase 應用程式 ID。您可以在下列兩個位置找到這個 ID：
- 在 Firebase 控制台中，依序前往「」>「Project settings」(專案設定)。前往「Your apps」(您的應用程式) 資訊卡，然後按一下 Firebase Apple 應用程式，查看應用程式資訊，包括「App ID」(應用程式 ID)。
- 在 Flutter 專案的頂層目錄中，找出 firebase_options.dart 檔案。Apple 應用程式的 Firebase 應用程式 ID 標示為 appId。
依序點按 >「New Run Script Phase」。

請確認這個新的「Run Script」階段是專案的最後一個建構階段。否則 Crashlytics 無法正確處理 dSYM。
展開新的「Run Script」部分。

注意： 在後續子步驟中，請務必複製並貼上指定的路徑，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：Firebase Apple 應用程式 ID (非 Apple 軟體包 ID)
  Firebase Apple 應用程式 ID 範例：1:1234567890:ios:321abc456def7890
需要找出 Firebase 應用程式 ID 嗎？
您可以透過下列兩種方式找出 Firebase 應用程式 ID：
- 在 GoogleService-Info.plist 檔案中，應用程式 ID 是 GOOGLE_APP_ID 值；或
- 在 Firebase 控制台中，前往「 Project settings」(專案設定) 。前往「Your apps」(您的應用程式) 資訊卡，然後按一下要查看應用程式 ID 的 Firebase 應用程式。
在「Input Files」(輸入檔案) 區段中，新增下列檔案的位置路徑：
```
${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 會在指定位置尋找這些輸入檔案，確保建構檔案可供執行指令碼使用。此外，如果啟用「User Script Sandboxing」，Xcode 只會允許執行指令碼存取「Input Files」中指定的檔案。
- 提供專案 dSYM 檔案的位置，Crashlytics 就能處理 dSYM。
- 提供應用程式建構的 GoogleService-Info.plist 檔案位置，Crashlytics 就能將 dSYM 與 Firebase 應用程式建立關聯。
- 提供應用程式執行檔的位置，可讓執行指令碼避免重複上傳相同的 dSYM。請注意，系統不會上傳應用程式二進位檔。

執行指令碼，自動上傳現有的 dSYM

如果執行指令碼確實存在，請參閱 Apple 專屬指南，瞭解如何排解 dSYM 問題。如果您選擇透過上述程序上傳 dSYM 檔案，則需要採取下列額外步驟：

找出 Apple 應用程式的 Firebase 應用程式 ID。您可以在下列兩個位置找到這個 ID：
- 在 Firebase 控制台中，依序前往「」>「Project settings」(專案設定)。前往「Your apps」(您的應用程式) 資訊卡，然後按一下 Firebase Apple 應用程式，查看應用程式資訊，包括「App ID」(應用程式 ID)。
- 在 Flutter 專案的頂層目錄中，找出 firebase_options.dart 檔案。Apple 應用程式的 Firebase 應用程式 ID 標示為 appId。
執行 upload-symbols 指令碼時，請使用 -ai FIREBASE_APPLE_APP_ID，而非 -gsp /path/to/GoogleService-Info.plist。

檢查 Flutter 和 Crashlytics 的版本設定(如果使用 `--split-debug-info` 旗標)

如果 Flutter 專案使用 --split-debug-info 旗標 (以及 --obfuscate 旗標，如有需要)，則須採取額外步驟，才能為應用程式顯示可讀的堆疊追蹤。

請確認專案使用的是建議的版本設定 (Flutter 3.12.0 以上版本和 Crashlytics Flutter 外掛程式 3.3.4 以上版本)，這樣專案才能自動產生 Flutter 符號 (dSYM 檔案) 並上傳至 Crashlytics。

Android

檢查依附元件設定

flutterfire configure 指令會嘗試將必要的依附元件新增至專案的 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` 旗標)

如果 Flutter 專案使用 --split-debug-info 旗標 (以及 --obfuscate 旗標，如有需要)，則須採取額外步驟，才能為應用程式顯示可讀的堆疊追蹤。

使用 Firebase CLI (11.9.0 以上版本) 上傳 Flutter 偵錯符號。您必須先上傳偵錯符號，才能回報經過模糊處理的程式碼建構作業當機情形。

在 Flutter 專案的根目錄中，執行下列指令：

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

FIREBASE_APP_ID：Firebase Android 應用程式 ID (而非套件名稱)
Firebase Android 應用程式 ID 範例：1:567383003300:android:17104a2ced0c9b9b
需要找出 Firebase 應用程式 ID 嗎？
您可以透過下列兩種方式找出 Firebase 應用程式 ID：
- 在 google-services.json 檔案中，應用程式 ID 是 mobilesdk_app_id 值；或
- 在 Firebase 控制台中，前往「 Project settings」(專案設定) 。前往「Your apps」(您的應用程式) 資訊卡，然後按一下要查看應用程式 ID 的 Firebase 應用程式。
PATH/TO/symbols：建構應用程式時，傳遞至 --split-debug-info 旗標的相同目錄

如果問題仍未解決，請參閱 Android 專用指南，瞭解如何排解經過模糊處理的報告。