기술 자료

지원

Cloud Diagnostics

Cloud Diagnostics

기호 파일 업로드

Manually upload application symbol files to improve crash report symbolication and readability.
읽는 시간 1분최근 업데이트: 한 달 전
네이티브 크래시 리포트에는 누락된 기호가 있을 수 있습니다. 프로젝트에 누락된 기호가 있는 경우 애플리케이션 기호 파일을 프로젝트에 수동으로 추가할 수 있습니다. 이는 문제를 더 잘 진단하고 해결하는 데 도움이 됩니다. 크래시 및 예외 리포트에 누락된 기호가 있다면 Cloud Diagnostics Dashboard에서 애플리케이션 기호 파일을 추가합니다.
기호를 업로드하려면 다음 단계를 따릅니다.
  1. Unity Dashboard를 엽니다.
  2. Cloud Diagnostics가 활성화된 프로젝트를 엽니다.
  3. 왼쪽 내비게이션에서 Cloud Diagnostics > Debugging Symbols를 선택합니다.
  4. Debugging Symbols 페이지에서 Upload Symbols를 선택하고 컴퓨터에서 파일을 선택합니다.
새 기호를 업로드할 때 업로드 후 사용 가능해지기까지 약간의 시간이 걸립니다. 새 크래시를 제출하기 전에 5분 이상 대기합니다. 처리되면 새 리포트가 알맞은 기호와 함께 생성될 것입니다.

누락된 iOS/OSX 애플리케이션 기호 찾기 및 업로드

Xcode를 사용하여 애플리케이션을 만들 때 iOS/OSX는 기호를 다음과 유사한 이름의 dSYM 폴더에 저장합니다. 
~/Library/Developer/Xcode/DerivedData/<build id>;/Build/Products/<build type>/appname.dSYM
dSYM 파일은 애플리케이션에 대한 DWARF(Debugging With Attributed Record Formats) 디버깅 정보를 포함하는 ELF 파일입니다. DWARF는 소스 레벨 디버깅을 지원하는 디버깅 파일 포맷입니다. dSYM이 올바른 UUID를 포함하는지 확인하려면 다음과 같이 
dwarfdump
명령을 실행하고 
appname
을 애플리케이션의 dSYM으로 대체합니다. 
dwarfdump -u appname.dSYM/Contents/Resources/DWARF/appname
다음은 
dwarfdump
의 샘플 출력을 보여 줍니다. 
UUID: 5EEDCCD2-38E7-3E52-81EC-B90C7BCD6D91 (armv7) appname.dSYM/Contents/Resources/DWARF/appname
 
UUID: 583173FD-6697-3E3C-90DC-EA9147563A5B (arm64) appname.dSYM/Contents/Resources/DWARF/appname
 참고: dwarfdump는 DWARF 정보를 사람이 읽을 수 있는 포맷으로 출력하는 애플리케이션입니다. dwarfdump의 출력은 UUID를 대시(—)가 있는 대문자로 리포트합니다. UUID는 종종 대시 없이 모두 소문자로 표시됩니다. 두 포맷 모두 UUID를 나타낼 수 있습니다. 예를 들어 
5EEDCCD2-38E7-3E52-81EC-B90C7BCD6D91
및 
5eedccd238e73e5281ecb90c7bcd6d91
은 모두 동일한 UUID를 나타냅니다. 올바른 dSYM 폴더를 찾은 다음 전체 폴더를 압축한 뒤 Unity Dashboard의 Debugging Symbols 탭을 사용하여 Cloud Diagnostics 서비스로 업로드합니다.

iOS, Bitcode, App Store

Bitcode를 활성화한 iOS 앱을 만들어 App Store에 제출하는 경우, Apple은 빌드를 포스트 프로세싱하여 새 바이너리를 생성합니다. 이 새 바이너리에는 새 UUID와 그에 상응하는 새 dSYM이 있습니다. 이 경우 iTunes Connect에서 dSYM을 다운로드해야 합니다. iTunes Connect의 My Apps > Activity > All Builds > **(내 빌드 선택)**에서 이용 가능합니다. App Store에 앱을 업로드할 때 Include bitcode for iOS content 및 Upload your app’s symbols to receive symbolicated reports from Apple을 체크하여 App Store가 올바른 기호로 새 dSYM을 생성하게 합니다. 새 dSYM을 다운로드한 뒤 dwarfdump를 사용하여 UUID가 올바른지 확인합니다. 파일을 압축하여 Debugging Symbols 탭을 통해 Cloud Diagnostics 서비스로 업로드합니다. 기호에 대한 자세한 내용은 Apple Developer 웹 사이트의 크래시 리포트 기호화를 참고하십시오. 참고: 새 dSYM ID를 업로드할 때 리포트가 다시 기호화되지 않습니다. 새 기호를 사용하여 리포트를 생성하려면 새 크래시를 제출해야 합니다.