Crashlytics 대시보드에서 읽을 수 있는 비정상 종료 보고서 받기

iOS+ Android Flutter Unity

기본적으로 Firebase Crashlytics는 디버그 기호(dSYM) 파일을 자동 처리해 사람이 읽을 수 있는 가독화된 비정상 종료 보고서를 제공합니다. 이 동작은 Crashlytics를 앱의 빌드 단계로 초기화하는 실행 스크립트를 추가할 때 설정됩니다.

dSYM 업로드에 실패하는 상황이 몇 가지 있는데 대부분은 고유의 프로젝트 구성 또는 앱의 비트코드가 그 원인입니다. 이 가이드에서는 Crashlytics가 앱의 dSYM을 찾을 수 없을 때 문제를 해결할 수 있는 몇 가지 방법을 제공합니다.

Xcode의 dSYM 생성 확인

일반적으로 dSYM 파일이 누락되는 이유는 Xcode가 dSYM 파일을 생성하지 않기 때문입니다. 업로드에 실패하면 Crashlytics에서 'dSYM 누락' 알림을 Firebase Console에 표시합니다. 이 알림을 받을 경우 먼저 Xcode로 각 빌드에 올바른 dSYM 파일이 생성되는지 확인합니다.

1. Xcode에서 프로젝트를 열고 Xcode 탐색기에서 해당 프로젝트 파일을 선택합니다.

2. 기본 빌드 대상을 선택합니다.

3. 대상의 Build Settings(빌드 설정) 탭을 열고 All(전체)을 클릭합니다.

4. 'debug information format'(디버그 정보 형식)을 검색합니다.

5. 모든 빌드 유형의 Debug Information Format(디버그 정보 형식)을 DWARF with dSYM File(dSYM 파일로 DWARF)로 설정합니다.

6. 앱을 다시 빌드합니다.

이제 비정상 종료 보고서가 Firebase Console에 표시됩니다. 문제가 지속되거나 다른 오류가 발생하면 dSYM을 찾아 Crashlytics에 수동으로 업로드해 보세요.

dSYM 찾기

Crashlytics가 비트코드 구성 또는 콘솔 연결로 인해 앱의 dSYM을 찾을 수 없는 경우도 있습니다. 이 경우 다음 두 가지 방법으로 문제를 해결할 수 있습니다.

App Store에서 비트코드 dSYM 다운로드

Apple은 App Store에 출시되거나 TestFlight에 제출된 비트코드 설정 빌드에 대한 새 dSYM을 생성합니다. 다음 중 하나라도 앱에 적용되면 App Store에서 해당하는 새 dSYM을 다운로드합니다.

1. App Store Connect에 로그인한 다음 My Apps(내 앱) > Activity(활동)를 클릭합니다.
2. dSYM을 다운로드할 빌드를 선택합니다.
3. Build Details(빌드 세부정보) > Download dSYM(dSYM 다운로드)을 클릭합니다.

로컬 머신에서 dSYM 찾기

다음을 실행하여 머신에 있는 모든 dSYM의 UUID를 표시한 후 누락된 dSYM을 검색합니다.

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

dSYM을 찾으면 Crashlytics에 업로드합니다. mdfind 명령어가 결과를 반환하지 않으면 .app이 있는 Products 디렉터리에서 결과를 볼 수 있습니다. 기본적으로 Products 디렉터리는 Derived Data에 있습니다. 앱이 프로덕션으로 출시된 경우 디스크의 .xcarchive 디렉터리에서 해당 dSYM을 찾을 수도 있습니다.

1. Xcode에서 Organizer(구성자) 창을 열고 목록에서 앱을 선택합니다. Xcode에 프로젝트의 보관 파일 목록이 표시됩니다.
2. 보관 파일을 Control-클릭하여 Finder에서 확인합니다. 그런 다음 다시 Control-클릭하고 Show Package Contents(패키지 콘텐츠 표시)를 클릭합니다.

.xcarchive 내에는 Xcode 보관 프로세스 도중에 생성된 dSYM이 포함된 dSYM 디렉터리가 있습니다. 다시 컴파일된 비트코드 dSYM은 Organizer(구성자) 창에서 Download dSYMs(dSYM 다운로드)... 도구를 사용할 때 이 폴더에도 다운로드됩니다.

dSYM 업로드

dSYM을 수동으로 업로드하려면 콘솔 기반 '드래그 앤 드롭' 옵션을 사용하여 dSYM 파일이 포함된 zip 파일을 업로드하세요(Firebase Console로 이동 > Crashlytics > dSYM 탭).

또한 Crashlytics에는 백업으로 빌드 프로세스 중 언제든 호출해 dSYM 파일을 직접 업로드할 수 있는 스크립트인 upload-symbols도 포함되어 있습니다. 이 스크립트는 업로드 프로세스에 관한 자세한 정보와 보다 종합적인 오류 메시지를 제공합니다. 사용법 참고사항 및 추가 안내는 매개변수 없이 upload-symbols를 실행하여 확인하세요.

비트코드 dSYM을 업로드할 때 다음을 실행하여 zip 파일에 있는 아이콘 파일을 삭제하는 것이 도움이 될 수 있습니다.

unzip appDsyms.zip
cd appDsyms rm -rf $(find . | grep Icon)
# Enumerate all the dSYMs
upload-symbols ... $(ls)

upload-symbols 스크립트를 실행하려면 다음 옵션 중 하나를 사용합니다.

• 빌드 프로세스에 다음 줄을 포함시킵니다.

  find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}

• 터미널에서 직접 스크립트를 실행합니다.

  /PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs