앱의 dSYM 파일은 Xcode의 dSYM 아카이브 경로 폴더에 저장됩니다. 이것은 iOS 에이전트가 충돌 보고서를 상징화하는 데 사용되는 dSYM 파일을 가져오는 폴더입니다. New Relic은 iOS 에이전트 설치 프로세스의 일부로 빌드 후 스크립트를 제공합니다. 이 스크립트는 dSYM을 New Relic 맵 파일 형식으로 자동 변환하고 충돌 기호화에 필요한 파일을 New Relic에 업로드합니다.
자동 스크립트
Swift 스크립트는 Xcode의 대상 빌드 단계에서 빌드 스크립트에서 실행되도록 의도된 iOS 에이전트에 포함되어 있습니다. 이 스크립트는 백그라운드에서 dSYM 파일을 자동으로 업로드(또는 dSYM을 New Relic 맵 파일 형식으로 변환)한 다음 New Relic에 충돌 기호화에 필요한 파일의 백그라운드 업로드를 수행합니다.
Xcode 14에서 Apple은 새로 생성된 프로젝트의 기본 설정을 변경하여 비트코드를 비활성화했습니다. App Store는 이제 비트코드가 꺼져 있는 앱 제출만 수락합니다. Xcode 14 릴리스 정보 를 참조하십시오. 프로젝트에 여전히 비트코드가 활성화되어 있으면 비활성화해야 합니다. 자동 스크립트를 사용하려면 비트코드를 비활성화해야 합니다.
Apple은 Bitcode 지원 앱용 dSYM 파일을 생성합니다. Apple에서 Bitcode 지원 앱용 dSYM 파일을 다운로드 하고 모바일 모니터링 UI 를 통해 New Relic에 업로드해야 합니다.
Crashes 페이지 에 읽을 수 없는 기계어 코드가 있으면 dSYM 파일이 올바르게 업로드되지 않은 것일 수 있습니다. 경우에 따라 dSYM 파일을 수동으로 업로드 해야 할 수도 있습니다.
New Relic iOS 에이전트 버전 7.4.0에서 Swift를 사용하는 새로운 기호 업로드 스크립트를 도입했습니다. 기호 업로드 스크립트의 Python 버전은 계속 사용할 수 있지만 향후 릴리스에서 제거될 예정입니다. New Relic iOS 에이전트 버전 7.3.8에서 자동 스크립트의 Python 버전은 Python 3을 사용합니다. macOS 12.3 macOS 12.3(Monterey)을사용하는 경우 Python 3이 기본적으로 Xcode와 함께 설치됩니다. 그러나 macOS 12.2 이하에서 Python 자동 스크립트를 사용하는 경우 Python 3을수동으로 설치해야 할 수 있습니다.
누락된 dSYM 식별
Bitcode 지원 앱이 App Store 검토 또는 임시 배포를 위해 Apple에 업로드되면 dSYM을 Apple에서 수동으로 다운로드하고 New Relic에 업로드해야 모바일 충돌 보고서 가 제대로 기호화될 수 있습니다. 이러한 dSYM은 앱을 업로드한 후 몇 분 이내에 Xcode의 아카이브 구성자를 통해 다운로드할 수 있습니다. 이 상황에서 절차에 따라 아카이브를 찾고 dSYM을 다운로드합니다 .
앱에 dSYM 파일이 없으면 모바일 모니터링 UI에 세 가지 표시기가 표시됩니다.
Banner notification
:
페이지 에 배너 경고가 나타납니다. 경고 내용은 다음과 같습니다.
We were unable to locate your dsym.Upload prompt
: dSYM 파일이 누락된 경우
Crash type summary
페이지에서 자동으로 업로드하게 됩니다.
Machine code
:
Crash report
페이지의 충돌 스택 추적은 사람이 읽을 수 있는 오류 메시지가 아닌 기계어 코드를 표시합니다.
모바일 모니터링 UI를 통해 dSYM 파일 업로드
New Relic UI에서 직접 dSYM 파일을 쉽게 업로드할 수 있습니다. 최대 파일 크기는 600MB입니다. dSYM 파일을 업로드하려면:
one.newrelic.com > All capabilities > Mobile
로 이동합니다. 그런 다음 목록에서 앱을 선택하세요.
Crash analysis
보기.
Crash types
목록에서 특정 충돌을 선택합니다.
Upload dSYM
클릭합니다. dSYM을 직접 끌어서 놓거나 컴퓨터에서 파일을 선택할 수 있습니다.
수동으로 dSYM 파일 업로드
경우에 따라 New Relic의 dSYM 파일 자동 업로드가 실패할 수 있습니다. dSYM 업로드가 실패하면 upload_dsym_results 파일이 생성됩니다. 예를 들어, 네트워크 오류가 있고 dSYM 업로드가 완료되지 않은 경우 upload_dsym_results 에는 무엇이 잘못되었는지에 대한 로그가 포함됩니다. New Relic이 dSYM 업로드를 처리하는 방법에 대한 추가 정보는 New Relic의 온라인 기술 커뮤니티 를 참조하십시오.
자동 업로드에 실패하면 dSYM 파일을 수동으로 업로드할 수 있습니다. dSYM 파일이 여러 개인 경우 최대 파일 크기가 600MB인 단일 zip 내에 있을 수 있습니다. 아래 명령의 YOUR_NEW_RELIC_APPLICATION_TOKEN 값은 +[NewRelic startWithApplicationToken:] (Objective-C) 또는 NewRelic.start(withApplicationToken:) (Swift)에 사용되는 것과 동일한 키입니다.
dSYM 파일을 수동으로 업로드하려면:
문제점 해결
자동 스크립트는 기호 업로드 중에 발생하는 모든 실패에 대한 정보를 포함하는 프로젝트의 루트 디렉토리에 upload_dsym_results.log 파일을 생성합니다.
dSYM 누락
dSYM 파일이 없는 경우 Xcode 빌드 설정을 확인하여 파일이 생성되고 있는지 확인해야 할 수 있습니다. 로컬로 빌드된 프레임워크에는 별도의 빌드 설정이 있으며 업데이트해야 할 수도 있습니다.
빌드 설정:
Debug Information Format : Dwarf with dSYM FileDeployment Postprocessing: YesStrip Linked Product: YesStrip Debug Symbols During Copy : Yes