비정상 종료 스택 트레이스 가독화 또는 기호화

Android에서 비정상 종료 및 ANR이 발생하면 비정상 종료가 일어난 시점까지 프로그램에서 호출된 일련의 중첩 함수를 스냅샷으로 보여주는 스택 트레이스가 생성됩니다. 이러한 스냅샷은 소스의 문제를 식별하고 해결하는 데 도움이 됩니다.

Java를 사용하여 앱 또는 게임을 개발했으며 ProGuard를 사용하여 앱을 최적화 및 난독화한 경우 Play Console에서 앱의 각 버전에 대한 ProGuard 매핑 파일을 업로드할 수 있습니다. C++와 같은 네이티브 코드를 사용하여 앱 또는 게임을 개발했다면 Play Console에서 앱의 각 버전에 대한 디버그 기호 파일을 업로드할 수 있습니다. 이렇게 하면 비정상 종료 및 ANR을 분석하고 해결하기가 더 쉬워집니다.

중요: 자바로 컴파일된 앱의 가독화에는 ReTrace 호환 매핑 파일만 지원됩니다. 이는 ProGuard 또는 R8에서 사용하는 형식과 동일합니다.

1단계: 가독화 또는 기호화 파일 생성

앱의 특정 버전에 대해 앱의 비정상 종료 및 ANR을 가독화 또는 기호화하려면 먼저 동일한 앱 버전에 필요한 파일을 생성해야 합니다. 가독화 또는 기호화가 작동하려면 앱의 새 버전마다 파일을 생성하고 업로드해야 합니다.

자바: ProGuard 매핑 파일 생성

네이티브: 디버그 기호 파일 생성

Android Gradle 플러그인 버전 4.1 이상

프로젝트가 Android App Bundle을 빌드하는 경우 디버그 기호 파일을 자동으로 포함할 수 있습니다. 이 파일을 포함하려면 앱의 build.gradle 파일에 다음을 추가합니다.

android.defaultConfig.ndk.debugSymbolLevel = 'FULL'

참고: 디버그 기호 파일의 크기는 800MB로 제한됩니다. 디버그 기호의 사용량이 너무 크면 FULL 대신 SYMBOL_TABLE을 사용하여 파일 크기를 줄입니다.

프로젝트가 APK를 빌드하는 경우 위의 build.gradle 빌드 설정을 사용하여 디버그 기호 파일을 별도로 생성합니다. 2단계: 가독화 또는 기호화 파일 업로드에 설명된 대로 디버그 기호 파일을 Google Play Console에 수동으로 업로드합니다. 빌드 프로세스의 일부로 Android Gradle 플러그인은 다음 프로젝트 위치에 이 파일을 출력합니다.

app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Android Gradle 플러그인 버전 4.0 이하 (및 기타 빌드 시스템)

Android Gradle 플러그인은 App Bundle 또는 APK의 빌드 프로세스의 일부로 제거되지 않은 라이브러리의 사본을 프로젝트 디렉터리에 보관합니다. 이 디렉터리는 다음과 유사한 구조를 따릅니다.

app/build/intermediates/cmake/universal/release/obj

├── armeabi-v7a/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

├── arm64-v8a/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

├── x86/

│ ├── libgamenegine.so

│ ├── libothercode.so

│ └── libvideocodec.so

└── x86_64/

├── libgameengine.so

├── libothercode.so

└── libvideocodec.so

참고: 다른 빌드 시스템을 사용하는 경우, 위와 같은 필수 구조를 가진 디렉터리에 제거되지 않은 라이브러리를 저장하도록 수정할 수 있습니다.

다음 디렉터리의 콘텐츠를 압축합니다.
- $ cd app/build/intermediates/cmake/universal/release/obj
- $ zip -r symbols.zip .
아래의 2단계: 가독화 또는 기호화 파일 업로드에 설명된 대로 symbols.zip 파일을 Play Console에 수동으로 업로드합니다.

디버그 기호 파일의 크기는 800MB로 제한됩니다. 파일이 너무 큰 경우 .so 파일에 기호 테이블(함수 이름) 및 DWARF 디버깅 정보(파일 이름 및 코드 줄)가 포함되었기 때문일 수 있습니다. 이는 코드를 기호화하는 데 필요하지 않으며 다음 명령어를 실행하여 삭제할 수 있습니다.

$OBJCOPY --strip-debug lib.so lib.so.sym

참고: $OBJCOPY는 제거할 ABI의 특정 버전을 가리킵니다. 예:ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy

2단계: 가독화 또는 기호화 파일 업로드

앱의 특정 버전에 대해 앱의 비정상 종료 및 ANR을 가독화 또는 기호화하려면 앱의 각 버전에 대한 가독화 또는 기호화 파일을 업로드해야 합니다.

중요: 이 단계는 APK를 사용하는 개발자에게만 필요합니다. App Bundle 및 Android Gradle 플러그인 버전 4.1 이상을 사용하는 경우 별도의 조치를 취할 필요가 없습니다. 번들에서 가독화 파일을 자동으로 가져오므로 3단계: 가독화된 비정상 종료 스택 트레이스 보기로 건너뛸 수 있습니다. Android 개발자 사이트에서 App Bundle에 관해 자세히 알아볼 수 있습니다.

Play Console을 사용한 파일 업로드