Android NDK 충돌 보고서 받기

Android 앱에 기본 라이브러리 가 포함된 경우 앱의 빌드 구성을 약간 업데이트하여 Firebase Crashlytics의 기본 코드에 대한 전체 스택 추적 및 자세한 비정상 종료 보고서를 사용 설정할 수 있습니다.

이 가이드에서는 NDK용 Firebase Crashlytics SDK로 비정상 종료 보고를 구성하는 방법을 설명합니다.

Unity 프로젝트에서 Crashlytics를 시작하는 방법을 찾고 있다면 Unity 시작 가이드 를 확인하세요.

시작하기 전에

1. 아직 추가하지 않았다면 Android 프로젝트에 Firebase 를 추가하세요. Android 앱이 없는 경우 샘플 앱 을 다운로드할 수 있습니다.

2. 권장사항 : 비정상 종료 사용자, 탐색경로 로그, 속도 알림과 같은 기능을 사용하려면 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정해야 합니다.

   • 기존 Firebase 프로젝트에 Google 애널리틱스가 활성화되지 않은 경우 Firebase 콘솔의 settings > 프로젝트 설정 의 통합 탭 에서 Google 애널리틱스를 활성화할 수 있습니다.

   • 새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 활성화하세요.

1단계 : 앱에 NDK용 Crashlytics SDK 추가

Crashlytics 사용 환경을 최적화하려면 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정하고 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것이 좋습니다.

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.0')

    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ndk'
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

dependencies {
    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ndk:18.3.3'
    implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
}

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.0')

    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ndk'
    implementation 'com.google.firebase:firebase-analytics'
}

dependencies {
    // Add the dependencies for the Crashlytics NDK and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ndk:18.3.3'
    implementation 'com.google.firebase:firebase-analytics:21.2.0'
}

2단계 : 앱에 Crashlytics Gradle 플러그인 추가

1. 루트 수준(프로젝트 수준) Gradle 파일( <project>/build.gradle )에서 Crashlytics Gradle 플러그인을 buildscript 종속 항목으로 추가합니다.

   buildscript {
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
           ...
           classpath 'com.android.tools.build:gradle:7.2.0'
   
           // Make sure that you have the Google services Gradle plugin dependency
           classpath 'com.google.gms:google-services:4.3.15'
   
           // Add the dependency for the Crashlytics Gradle plugin
           classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.2'
       }
   }

2. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle )에서 Crashlytics Gradle 플러그인을 추가합니다.

   plugins {
       id 'com.android.application'
   
       // Make sure that you have the Google services Gradle plugin
       id 'com.google.gms.google-services'
   
       // Add the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics'
       ...
   }

3단계 : 빌드에 firebaseCrashlytics 확장 프로그램 추가

모듈(앱 수준) Gradle 파일 (일반적으로 app/build.gradle )에서 firebaseCrashlytics 확장 프로그램을 추가합니다.

// ...

android {
  // ...
  buildTypes {
      release {
          // Add this extension
          firebaseCrashlytics {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled true
          }
      }
  }
}

// ...

android {
  // ...
  buildTypes {
      release {
          // Add this extension
          firebaseCrashlytics {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled true
          }
      }
  }
}

4단계 : 네이티브 기호 자동 업로드 설정

NDK 비정상 종료에서 읽을 수 있는 스택 추적을 생성하려면 Crashlytics가 기본 바이너리의 기호에 대해 알아야 합니다. Crashlytics Gradle 플러그인에는 이 프로세스를 자동화하는 uploadCrashlyticsSymbolFile BUILD_VARIANT 작업이 포함되어 있습니다.

1. 자동화된 기호 업로드 작업에 액세스할 수 있도록 모듈(앱 수준) Gradle 파일에서 nativeSymbolUploadEnabled 가 true 로 설정되어 있는지 확인하십시오.

2. 메서드 이름이 스택 추적에 표시되려면 각 NDK 라이브러리 빌드 후 uploadCrashlyticsSymbolFile BUILD_VARIANT 작업을 명시적으로 호출해야 합니다. 예를 들어:

   >./gradlew app:assembleBUILD_VARIANT\
              app:uploadCrashlyticsSymbolFileBUILD_VARIANT
   

3. NDK용 Crashlytics SDK와 Crashlytics Gradle 플러그인은 모두 기본 공유 객체 내에 GNU 빌드 ID가 있어야 합니다.

   각 바이너리에서 readelf -n 을 실행하여 이 ID의 존재를 확인할 수 있습니다. 빌드 ID가 없으면 빌드 시스템의 플래그에 -Wl,--build-id 를 추가하여 문제를 해결하십시오.

5단계 : 테스트 충돌을 강제로 설정을 완료합니다.

Crashlytics 설정을 완료하고 Firebase 콘솔의 Crashlytics 대시보드에서 초기 데이터를 보려면 강제로 테스트 비정상 종료를 실행해야 합니다.

1. 테스트 비정상 종료를 강제하는 데 사용할 수 있는 코드를 앱에 추가합니다.

   앱의 MainActivity 에서 다음 코드를 사용하여 눌렀을 때 충돌을 일으키는 버튼을 앱에 추가할 수 있습니다. 버튼에는 "Test Crash"라는 라벨이 붙어 있습니다.

   Kotlin+KTX

   val crashButton = Button(this)
   crashButton.text = "Test Crash"
   crashButton.setOnClickListener {
      throw RuntimeException("Test Crash") // Force a crash
   }
   
   addContentView(crashButton, ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT))
   

   Java

   Button crashButton = new Button(this);
   crashButton.setText("Test Crash");
   crashButton.setOnClickListener(new View.OnClickListener() {
      public void onClick(View view) {
          throw new RuntimeException("Test Crash"); // Force a crash
      }
   });
   
   addContentView(crashButton, new ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT));
   

2. 앱을 빌드하고 실행합니다.

3. 앱의 첫 번째 충돌 보고서를 보내려면 테스트 충돌을 강제 실행합니다.

   1. 테스트 장치 또는 에뮬레이터에서 앱을 엽니다.

   2. 앱에서 위의 코드를 사용하여 추가한 "Test Crash" 버튼을 누릅니다.

   3. 앱이 비정상 종료된 후 앱이 비정상 종료 보고서를 Firebase로 보낼 수 있도록 앱을 다시 시작하세요.

4. Firebase 콘솔의 Crashlytics 대시보드 로 이동하여 테스트 비정상 종료를 확인하세요.

   콘솔을 새로 고쳤는데도 5분 후에도 테스트 충돌이 표시되지 않으면 디버그 로깅을 활성화 하여 앱이 충돌 보고서를 보내고 있는지 확인하십시오.

그리고 그게 다야! 이제 Crashlytics에서 앱의 비정상 종료를 모니터링하고 있으며 Crashlytics 대시보드에서 비정상 종료 보고서 및 통계를 보고 조사할 수 있습니다.

기호 업로드를 위한 대체 옵션

위 페이지의 기본 워크플로는 표준 Gradle 빌드에 적용할 수 있습니다. 그러나 일부 앱은 다른 구성 또는 도구(예: Gradle 이외의 빌드 프로세스)를 사용합니다. 이러한 상황에서 기호를 성공적으로 업로드하는 데 다음 옵션이 도움이 될 수 있습니다.

옵션 : 라이브러리 모듈 및 외부 종속성에 대한 기호 업로드

이 옵션은 다음 상황에서 유용할 수 있습니다.

• Gradle 내에서 맞춤설정된 NDK 빌드 프로세스를 사용하는 경우
• 네이티브 라이브러리가 라이브러리/기능 모듈에 내장되어 있거나 타사에서 제공하는 경우
• 자동 기호 업로드 작업 이 실패하거나 대시보드에 기호화되지 않은 충돌이 표시되는 경우

옵션 : Gradle이 아닌 빌드 또는 액세스할 수 없는 제거되지 않은 기본 라이브러리에 대한 기호 업로드

이 옵션은 다음 상황에서 유용할 수 있습니다.

• Gradle 이외의 빌드 프로세스를 사용하는 경우

• 제거되지 않은 네이티브 라이브러리가 Gradle 빌드 중에 액세스할 수 없는 방식으로 제공되는 경우

문제 해결

Firebase 콘솔과 logcat에 서로 다른 스택 추적이 표시되는 경우 문제 해결 가이드 를 참조하세요.

다음 단계

• 옵트인 보고, 로그, 키 및 치명적이지 않은 오류 추적을 추가 하여 충돌 보고서 설정을 사용자 정의하십시오 .

• Crashlytics 대시보드에서 직접 Google Play 트랙별로 Android 앱의 충돌 보고서를 필터링할 수 있도록 Google Play와 통합 합니다. 이를 통해 대시보드를 특정 빌드에 더 집중할 수 있습니다.