Como gerar símbolos de depuração (debug symbols) para Godot no Windows e enviar ao Play Console

Sim, é possível gerar debug symbols para upload no Google Play Console, mas é fundamental que os símbolos correspondam exatamente ao build Android que você está publicando – a simbolização de stack traces só funciona se os debug symbols forem do mesmo export template .

Se você utiliza os export templates oficiais da Godot sem modificar a engine, a abordagem mais simples é baixar os debug symbols nativos disponibilizados pela própria Godot para cada versão estável .

Compilando no Windows com suas flags

1. Configure o Android SDK – Certifique-se de que o Android SDK está instalado e defina a variável de ambiente ANDROID_HOME apontando para a pasta do SDK . No Prompt de Comando:

set ANDROID_HOME=C:\Users\SeuNome\AppData\Local\Android\Sdk

2. Clone o código-fonte da Godot e faça checkout da mesma versão do editor/export template que você está usando – os debug symbols devem ser gerados a partir do mesmo código que produziu o build exportado .

git clone https://github.com/godotengine/godot.git
cd godot
git checkout 4.x

3. Execute o SCons dentro da pasta do código-fonte da Godot. A documentação da Sentry mostra que os export templates Android podem ser compilados com target=template_debug, platform=android, arch=arm32 e debug_symbols=yes para gerar templates com símbolos de depuração .

Para usar as flags que você mencionou (desde que a sua versão da Godot as aceite):

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

Para publicação no Play Console, prefira a build release

• Para o build que será publicado, recomenda-se usar a release template em vez da debug:

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

• Se quiser os símbolos em arquivos separados (recomendado para upload no Play Console), adicione 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

O que enviar para o Play Console

• Faça upload dos debug symbols gerados exatamente do mesmo build do AAB/APK que você está publicando. Stack traces só se tornam legíveis se os símbolos nativos corresponderem ao export template utilizado .

• Se o build não gerar automaticamente um arquivo ZIP pronto para upload, vale observar que o suporte nativo da Godot para separação de símbolos voltados ao Google Play já foi considerado não trivial e pode exigir procedimento manual .

• A estrutura exata do ZIP de símbolos nativos aceito pelo Play Console não está completamente detalhada nos materiais consultados.

Pontos importantes

• Nunca misture símbolos de versões diferentes da Godot ou de export templates distintos – os debug symbols devem ser do mesmo build exportado .

• Se você não alterou o código-fonte da Godot, é mais seguro baixar os debug symbols nativos oficiais da versão correspondente ao export template que você está usando .

• Se você modificou a engine ou compilou seu próprio template, utilize os símbolos gerados pela sua própria compilação, não os oficiais, pois eles precisam corresponder exatamente ao build exportado .

• A documentação existente não detalha o local exato de saída dos arquivos no Windows nem o processo de empacotamento do ZIP para o Play Console – para esses pontos específicos, as evidências são insuficientes.