Godot Android 除錯符號產生教學：上傳至 Play Console 的完整指南

使用 SCons 編譯自訂匯出模板

4. 在 Godot 原始碼根目錄下，執行下列 SCons 指令。這裡提供兩種常見情境：

如果您需要編譯除錯用的模板（一般用於開發測試）

如果您需要編譯準備上架的釋出模板（較常見）

額外建議：產生分離符號檔案

如果要單獨取得除錯符號檔案，不與執行檔混合，可以加上 separate_debug_symbols=yes 選項，這樣輸出的 .so 檔案會保持較小體積，符號單獨存放 ：

Sentry 的官方文件也示範了類似的指令，包括指定架構（如 arch=arm32、arch=arm64）以及 production=yes 等最佳化參數 。

Play Console 上傳須知

• 上傳的除錯符號檔案必須與相對應的 AAB 或 APK 來自同一次 SCons 建構，不能混合不同版本或不同架構的符號 。
• 如果建構完成後未自動產生可直接上傳的 ZIP 檔案，Godot 社群曾指出，將符號分離以配合 Google Play 的流程並非開箱即用，可能需要手動打包 。
• 在 Play Console 的「Deobfuscation and symbolication」區塊上傳時，通常需要一個包含 .sym 或 .so 符號檔案的 ZIP 壓縮包。由於證據中未提供最終結構細節，如果官方工具沒有自動產生 ZIP，建議手動將 lib 資料夾下對應架構（如 arm64-v8a）的符號檔案壓縮上傳。

重要提醒

• 請勿混用來自不同 Godot 版本或不同匯出模板的除錯符號，否則 Play Console 將無法正確解譯當機報告 。
• 如果你沒有修改任何 Godot 引擎原始碼，且不想自行編譯，直接下載官方提供的 Godot_native_debug_symbols.* 檔案會是更安全、更省時的選擇 。
• 如果你曾自行修改引擎原始碼或自訂模板，則一定要使用你自己編譯所產生的符號檔案，因為只有那些符號才能對應到修改後的執行檔 。

關於本文章所涵蓋的範圍

目前可獲得的證據對於 Windows 平台下建構輸出檔案的精確路徑，以及如何將符號打包成 Play Console 接受的 ZIP 檔案格式，提供的資訊尚不足夠。建議在建構完成後檢查 Godot 輸出目錄（通常是 bin/），並參考 Godot 官方討論區或 GitHub Issue 來確認最新流程。