Godot Android 빌드 디버그 심볼 생성 및 Google Play Console 업로드 가이드

2. Godot 소스 코드 클론

사용 중인 Godot 버전과 동일한 태그나 브랜치로 체크아웃합니다. 디버그 심볼은 반드시 출시할 exported build와 대응해야 하기 때문입니다 .

3. SCons로 빌드

문서에 따르면 debug symbols를 포함한 export template 컴파일은 scons 명령어로 수행합니다 .

요청하신 플래그를 그대로 사용하려면 (단, 사용 중인 Godot 버전이 해당 옵션을 지원해야 함):

Sentry 문서에서도 Android export template을 target=template_debug, platform=android, arch=arm32, debug_symbols=yes 옵션으로 컴파일하는 예제를 보여줍니다 .

Play Console 업로드용 릴리스 빌드 권장

실제 출시할 빌드라면 template_debug 대신 template_release를 사용하는 것이 좋습니다.

별도의 디버그 심볼 파일이 필요하다면 separate_debug_symbols=yes 플래그를 추가할 수 있습니다 :

Play Console에 업로드할 파일

• 업로드하는 AAB 또는 APK와 동일한 빌드에서 생성된 디버그 심볼을 업로드해야 합니다. 그래야만 스택 트레이스를 사람이 읽을 수 있는 형태로 변환할 수 있습니다 .
• 빌드 결과물이 자동으로 ZIP 파일로 생성되지 않는다면, Google Play 전용 심볼 분리 기능은 아직 완전히 지원되지 않아 수동 작업이 필요할 수 있습니다 .
• Google Play Console이 요구하는 정확한 ZIP 내부 구조에 대한 상세 정보는 현재 문서에서 충분히 확인되지 않습니다.

중요 주의사항

• 다른 버전의 Godot나 export template에서 생성된 심볼을 혼용하지 마세요. 디버그 심볼은 반드시 출시한 게임 빌드와 일치해야 합니다 .
• Godot 소스 코드를 수정하지 않았다면, 공식 디버그 심볼을 사용하는 것이 가장 안전합니다 .
• 소스 코드를 수정했거나 직접 템플릿을 빌드했다면, 직접 생성한 심볼을 사용해야 합니다. 공식 심볼은 일치하지 않습니다 .
• Windows 환경에서의 출력 파일 위치와 Play Console용 ZIP 패키징 과정에 대한 구체적인 정보는 현재 제공된 문서만으로는 부족합니다 (Insufficient evidence).