유니티 Debug Symbols 옵션이란?

유니티 Debug Symbols 옵션이란?

유니티에서 Android / Quest로 빌드할 때 보이는 Debug Symbols 옵션은

"크래시가 발생했을 때, 어디서 문제가 났는지 알 수 있도록 도와주는 설정"입니다.

 

그런데 이걸 이해하려면 먼저 알아야 할 개념이 있습니다.

 

아래에서 하나씩 알아보겠습니다.

---

크래시 수집이란?

게임이 죽었을 때(강제 종료) 남는 기록을 모아서 "왜 디바이스가 강제로 죽었는지"를 나중에 확인하는 과정이 크래시 수집입니다.

 

크래시 수집은 크게 2가지로 나뉩니다.

구분	의미	예시
로컬 수집	개발자가 직접 디바이스에서 로그를 뽑음	ADB logcat
원격 수집	유저 기기에서 난 크래시를 서버가 자동으로 모음	Meta Dashboard, Crashlytics

---

Debug Symbols는 어디에 끼어드는지?

Debug Symbols는 "Crash Log 번역기" 입니다.

상태 크래시	로그가 이렇게 보임
Symbols 없으면	libil2cpp.so + 0x123456 같은 주소만 보임
Symbols 있으면	함수명/위치가 풀려서 원인 추적이 쉬워짐

즉, 수집과 해석는 별개고 Debug Symbols는 해석 단계에 핵심입니다.

---

Debug Symbols 옵션을 어떻게 고르면 되는지?

Build Settings > Android > Debug Symbols을 확인해주시면 됩니다.

옵션	의미	추천 상황
Disabled (None)	심볼 생성 안 함	진짜 급하게 빌드만 할 때
Public	기본 수준만 생성	가벼운 운영
Full	가장 자세하게 생성	Quest/IL2CPP 운영에 가장 안전

Debug Symbols 켜는 방법

---

수집 방법은 디바이스마다 다르므로 각자 디바이스에 맞는 방식을 확인하시면 됩니다!