Article

Android 앱 배포: Google Play 네이티브 디버그 기호 업로드

2024. 7. 9.

문제 상황

Google Play Store 배포 시 나타나는 경고:

이 App Bundle 아티팩트 유형은 네이티브 코드를 포함하며 아직 디버그 기호가 업로드되지 않았습니다. 비정상 종료(crash) 및 ANR을 분석하기 위해 기호 파일을 업로드하는 것을 권장합니다.

선택사항처럼 보이지만, 사용자 피드백 분석과 안정성 관리를 위해 필수적인 단계입니다.

해결 방법

1단계: 심볼 파일 준비

프로젝트의 다음 경로로 이동합니다:

[project_root]/build/app/intermediates/merged_native_libs/release/out/lib

이 경로에는 ARM, ARM64, x86 등 여러 아키텍처의 네이티브 라이브러리가 있습니다. 이 폴더들을 모두 압축합니다.

2단계: App Bundle 탐색기에서 버전 선택

Google Play Console에서 App Bundle 탐색기로 이동합니다. 경고를 띄운 버전을 선택합니다.

3단계: 네이티브 디버그 기호 업로드

선택한 버전에서 “다운로드 > 네이티브 디버그 기호”에 위에서 압축한 파일을 업로드합니다.

Mac 사용자 주의사항

Windows에서는 간단하게 처리되지만, Mac에서 압축 시 주의가 필요합니다.

파일 탐색기에서 직접 압축하면 다음과 같은 에러가 나타날 수 있습니다:

The native debug symbols contain an invalid directory __MACOSX. 
Only Android ABIs are supported.

Mac에서는 터미널 명령어로 압축해야 합니다:

# 압축해야 할 폴더로 이동
cd [project_root]/build/app/intermediates/merged_native_libs/release/out/lib

# 정확히 압축
zip -r ./symbols.zip ./*

생성된 symbols.zip 파일을 Google Play Console에 업로드하면 됩니다.

핵심 정리

마치며

네이티브 디버그 기호 업로드는 선택이 아닌 필수사항입니다. 사용자가 보고하는 크래시와 ANR 문제를 정확히 분석하고, 신속하게 대응하기 위한 필수 인프라입니다. 배포 체크리스트에 항상 포함시켜 안정적인 앱 운영을 보장하세요.