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


iOS+(Apple 플랫폼)

Crashlytics Unity SDK 8.2.0 이상을 사용하는 Apple 플랫폼 앱의 경우 Firebase Unity 편집기 플러그인이 기호를 업로드하도록 Xcode 프로젝트를 자동으로 구성해 줍니다. 최신 버전을 다운로드하세요.

Android

Android 앱의 경우 Crashlytics Unity SDK 8.6.1 이상에 NDK 비정상 종료 보고가 자동으로 포함되어 있어 Crashlytics에서 Android의 Unity IL2CPP 비정상 종료를 자동으로 보고할 수 있습니다. 그러나 Crashlytics 대시보드에서 네이티브 라이브러리 비정상 종료에 대한 기호화된 스택 트레이스를 보려면 Firebase CLI를 사용하여 빌드 시간에 기호 정보를 업로드해야 합니다.

  1. Crashlytics Unity SDK v8.6.1 이상을 사용하고 있는지 확인합니다. 최신 버전을 다운로드하세요.

  2. 기호 업로드를 위한 환경 및 프로젝트를 설정합니다.

    1. 안내에 따라 Firebase CLI를 설치합니다.

      CLI를 이미 설치했다면 최신 버전으로 업데이트해야 합니다.

    2. (Android API 수준 30 이상을 사용하는 앱만 해당) 앱의 AndroidManifest.xml 템플릿을 업데이트하여 포인터 태그를 사용 중지합니다.

      1. Android 플레이어 설정(Android Player Settings) > 게시 설정(Publishing Settings) > 빌드(Build) > 커스텀 기본 매니페스트(Custom Main Manifest) 체크박스를 선택합니다.

      2. Assets/Plugins/Android/AndroidManifest.xml에 있는 매니페스트 템플릿을 엽니다.

      3. (8.8.0 이전의 SDK 버전을 사용하는 앱에만 해당) 다음 속성을 애플리케이션 태그에 추가합니다. <application android:allowNativeHeapPointerTagging="false" ... />

  3. 프로젝트를 빌드하고 기호를 업로드합니다.

    Firebase Console에서 기호화된 스택 트레이스를 보려는 출시 빌드 등을 만들 때마다 다음 단계를 완료합니다.

    1. 빌드 설정 대화상자에서 다음 중 하나를 수행합니다.

      • Android 스튜디오 프로젝트로 내보내 프로젝트를 빌드합니다.

      • Unity Editor에서 직접 APK를 빌드합니다.
        빌드하기 전에 빌드 설정 대화상자에서 CreateSYMBOL.zip 체크박스가 선택되어 있는지 확인합니다.

    2. 빌드가 완료되면 Crashlytics 호환 기호 파일을 생성하고 다음 Firebase CLI 명령어를 실행하여 Firebase 서버에 업로드합니다.

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: 패키지 이름이 아닌 Firebase Android 앱 ID
        Firebase Android 앱 ID 예시: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS: CLI에서 생성된 기호 파일 경로

        • Android 스튜디오 프로젝트로 내보냄 - PATH/TO/SYMBOLS는 unityLibrary/symbols 디렉터리를 나타내며 Gradle 또는 Android 스튜디오를 통해 앱을 빌드한 후 내보낸 프로젝트 루트에 생성됩니다.

        • Unity 내에서 APK를 직접 빌드 - PATH/TO/SYMBOLS는 빌드가 완료될 때 프로젝트 루트 디렉터리에서 생성된 압축된 기호 파일의 경로입니다(예: myproject/myapp-1.0-v100.symbols.zip).

      기호 파일 생성 및 업로드에 Firebase CLI 명령어를 사용하기 위한 고급 옵션 보기

      플래그 설명
      --generator=csym

      기본 Breakpad 생성기 대신 기존 cSYM 기호 파일 생성기를 사용합니다.

      사용하지 않는 것이 좋습니다. 기본 Breakpad 기호 파일 생성기를 사용하는 것이 좋습니다.

      --generator=breakpad

      Breakpad 기호 파일 생성기를 사용합니다.

      기호 파일 생성의 기본값은 Breakpad입니다. 빌드 구성에 symbolGenerator { csym() }를 추가했고 대신 Breakpad를 사용하도록 재정의하려는 경우에만 이 플래그를 사용합니다.

      --dry-run

      기호 파일을 생성하지만 업로드하지 않습니다.

      이 플래그는 전송된 파일의 콘텐츠를 검사하려는 경우에 유용합니다.

      --debug 디버깅 정보를 추가로 제공합니다.