Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Android로 배포하기

Android에서 게임이 충돌하면 Play Console이나 Firebase Crashlytics와 같은 기타 충돌 보고 도구에서 난독화된 스택 추적을 자주 볼 수 있습니다. 이러한 스택 추적을 사람이 읽을 수 있도록(기호화) 만들려면 게임에서 내보낸 빌드에 해당하는 기본 디버그 기호가 필요합니다.

Godot는 이제 각 공식 내보내기 템플릿에 대해 다운로드 가능한 기본 디버그 기호를 제공합니다.

공식 템플릿에 대한 네이티브 디버그 기호 가져오기

godot-cpp 저장소 의 사본.

예를 들어 4.5.1.stable 버전의 기본 디버그 기호를 가져오려면 다음을 수행하세요.

사용자 정의 빌드에 대한 네이티브 디버그 기호 가져오기

내보낸 템플릿과 기본 디버그 기호는 **동일한 빌드**에서 가져와야 하므로 **공식 내보내기 템플릿**을 사용하는 경우에만 공식 기호를 사용할 수 있습니다. **사용자 정의 내보내기 템플릿**을 작성하는 경우 일치하는 기호 파일을 직접 생성해야 합니다.

이렇게 하려면 scons 빌드 명령에 ``debug_symbols=yes separate_debug_symbols=yes``를 추가하세요. 그러면 사용자 정의 빌드에 대한 기본 디버그 기호가 포함된 ``android-template-release-native-symbols.zip``라는 파일이 생성됩니다.

Timer 예제

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

여러 아키텍처용으로 빌드하는 경우 ``generate_android_binaries=yes``가 사용되는 방식과 유사하게 마지막 빌드 명령에만 ``separate_debug_symbols=yes``를 포함해야 합니다.

scons platform=android arch=arm32 target=template_release debug_symbols=yes
scons platform=android arch=arm64 target=template_release debug_symbols=yes
scons platform=android arch=x86_32 target=template_release debug_symbols=yes
scons platform=android arch=x86_64 target=template_release debug_symbols=yes separate_debug_symbols=yes generate_android_binaries=yes

Google Play 스토어로 내보내기

기본 디버그 기호를 업로드하려면 다음 단계를 따르세요.

  1. `Play 콘솔 <https://play.google.com/console>`_을 엽니다.

  2. 선택

  3. 왼쪽 메뉴에서 ``Test and release > Latest releases and bundles``로 이동합니다.

../../../_images/play_console_latest_release_bundles.webp

  1. 이제 관련 번들을 선택하고 엽니다.

../../../_images/play_console_latest_release_bundles2.webp

  1. Downloads 탭을 선택하고 Assets 섹션까지 아래로 스크롤합니다.

../../../_images/play_console_app_bundle_explorer.webp

  1. Native debug symbols 옆에 있는 업로드 화살표 아이콘을 클릭하세요.

../../../_images/play_console_app_bundle_explorer2.webp

  1. 해당 빌드 버전에 해당하는 네이티브 디버그 기호 파일을 선택하고 업로드하세요.

../../../_images/play_console_upload_native_debug_symbols.webp

한 줄 case 명령문에서 콜론 이후.

  1. 만들기 릴리스 페이지에서 새 릴리스 번들을 찾으십시오.

../../../_images/play_console_create_new_release.webp

  1. 옆에 있는 점 3개 메뉴를 클릭합니다.

  2. 메뉴에서 ``Upload native debug symbols (.zip)``를 선택합니다.

../../../_images/play_console_create_new_release2.webp

  1. 해당 빌드 버전에 해당하는 네이티브 디버그 기호 파일을 선택하고 업로드하세요.

충돌 로그를 수동으로 기호화

Android NDK에 포함된 ndk-stack 도구를 사용하여 충돌 로그를 수동으로 기호화할 수도 있습니다.

참고

Android SDK가 이미 설치되어 있는 경우 SDK 위치의 ndk 폴더에서 ndk-stack 도구를 찾을 수 있습니다. 그렇지 않은 경우 `NDK 다운로드 페이지 <https://developer.android.com/ndk/downloads>`_에서 NDK를 직접 다운로드할 수 있습니다.

  1. 이전에 다운로드한(또는 사용자 지정 빌드로 생성한) 기본 디버그 기호 zip을 추출합니다.

  2. 충돌 로그를 텍스트 파일(예: crash.txt)에 저장합니다.

중요

``ndk-stack``는 충돌 로그를 구문 분석할 때 초기 별표 줄을 찾습니다. ``crash.txt``가 다음 줄로 시작하는지 확인하세요.

*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

  1. 충돌의 CPU 아키텍처와 일치하는 기호 디렉터리 경로(예: arm64-v8a)를 사용하여 ndk-stack을 실행합니다.

ndk-stack -sym path/to/native_debug_symbols/arm64-v8a/ -dump crash.txt

  1. 출력에는 Godot의 소스 코드(또는 사용자 정의 빌드)의 파일 이름과 줄 번호를 보여주는 기호화된 추적이 표시됩니다.