Godot Android 除錯符號生成教學：Windows 上傳 Play Console 終極懶人包

點解一定要用啱嘅 debug symbols？

想係 Google Play Console 度睇得明崩潰報告？你就要提供同你上傳嘅 AAB / APK 一模一樣嘅 native debug symbols 。如果符號對唔上，啲 stack trace 就會變成一堆亂碼，跟本搵唔到邊度出錯。

若果你無改過 Godot Engine，最慳水慳力嘅方法係直接喺 Godot 官網下載對應你 Engine 版本嘅 debug symbols，佢哋每個穩定版都會提供 。

但係如果你有特別需要，或者想自己郁過 Engine 源碼，咁就要自己生 symbol 喇。

Windows 上自己生 debug symbols 嘅步驟

1. 準備 Android SDK

先要裝好 Android SDK，然後係系統環境變數度 set ANDROID_HOME 指返 SDK 嗰個 folder 。例如開 Command Prompt 輸入：

set ANDROID_HOME=C:\Users\你嘅用戶名\AppData\Local\Android\Sdk

2. Clone Godot 源碼

一定要 clone 返同你而家用緊嘅 Editor / Export Template 完全一樣嘅版本，先可以確保 debug symbols 對應得上 。

git clone https://github.com/godotengine/godot.git
cd godot
git checkout 4.x  # 記住要改返你嘅版本號

3. 用 SCons 編譯（有齊你要嘅 Flags）

開 Command Prompt，行呢句 command 就可以編譯 debug template：

scons platform=android target=template_debug generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

以上係跟足你講嘅 generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes 呢幾個 Flag 。

不過提提你，真正要上傳去 Play Console 嘅 build，最好用 release template，唔好用 debug：

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

4. 分開 symbol 檔案（Optional）

如果你想要另外一個單獨嘅 symbol file嚟上傳，就加埋 separate_debug_symbols=yes ：

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes separate_debug_symbols=yes

咁樣 SCons 就會幫你另外整一個符號檔案。

5. 點樣上傳去 Play Console？

呢度有個重點：一定要上傳同你個 AAB/APK 完全同一 batch 編譯出嚟嘅 debug symbols，如果唔係 Stack Trace 就會解唔到。

• 如果你係直接 build 嘅，可以試下搵 build output 入面嘅 .so 檔案或者 ZIP 檔案。
• 不過證據顯示呢個功能早期嘅支援未係咁完善，可能要手動包裝 。
• 如果你係用官方 Template 嘅話，真係直接去網站 download 官方 symbols 最快最穩陣。

重要嘅注意事項

• 千祈唔好溝亂不同版本嘅 debug symbols，一定要對應返你 export build 嘅版本 。
• 如果冇改過 Godot Engine，官方下載嘅 debug symbols 已經夠用，完全唔使煩 。
• 如果有改過 Engine，就一定要用返你自己 build 出嚟嘅 symbols，唔可以用官方的 。

希望呢篇懶人包幫到各位 Godot 開發者，順利將 Android game 上傳到 Play Console！