Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

Firebase Crashlytics 시작하기

이 빠른 시작에서는 Firebase Crashlytics SDK를 사용해 앱에 Firebase Crashlytics를 설정하여 Firebase Console에서 포괄적인 비정상 종료 보고서를 확인하는 방법을 설명합니다.

시작하기 전에

  1. 아직 추가하지 않았다면 Android 프로젝트에 Firebase를 추가합니다. Android 앱이 없다면 샘플 앱을 다운로드하면 됩니다.

  2. 선택사항: 비정상 종료가 발생하지 않은 사용자, 탐색경로, 커스텀 이벤트와 같은 비정상 종료 측정항목을 가져오려면 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정해야 합니다.

    1. 기존 Firebase 프로젝트에 Google 애널리틱스가 사용 설정되지 않은 경우 > 프로젝트 설정통합에서 Google 애널리틱스를 사용 설정할 수 있습니다.

      새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 사용 설정합니다.

    2. 마지막으로 Google 애널리틱스 콘솔의 관리 탭 > 계정 설정 > 데이터 공유 설정에서 데이터 공유를 사용 설정합니다.

      이전 Firebase 프로젝트의 경우 Firebase Console에서 > 프로젝트 설정통합에서 데이터 공유를 사용 설정해야 할 수 있습니다.

1단계: Firebase Console에서 Crashlytics 설정

  1. Firebase Console의 왼쪽 탐색 패널에서 Crashlytics를 클릭합니다.

  2. Firebase 프로젝트에 등록된 앱이 여러 개 있는 경우 Console 상단 표시줄에 있는 Crashlytics 옆의 드롭다운에서 방금 추가한 앱을 선택합니다.

  3. Crashlytics 사용 설정을 클릭합니다.

2단계: 앱에 Firebase Crashlytics 추가

  1. 프로젝트 수준 build.gradle 파일에서 Crashlytics Gradle 플러그인을 buildscript 종속 항목으로 추가합니다.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    
        dependencies {
            // ...
    
            // Check that you have the Google Services Gradle plugin v4.3.2 or later
            // (if not, add it).
            classpath 'com.google.gms:google-services:4.3.5'
    
            // Add the Crashlytics Gradle plugin (be sure to add version
            // 2.0.0 or later if you built your app with Android Studio 4.1).
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.5.0'
        }
    }
    
    allprojects {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    }
       
  2. 앱 수준 build.gradle 파일에서 Crashlytics Gradle 플러그인을 적용합니다.
    apply plugin: 'com.android.application'
    
    apply plugin: 'com.google.gms.google-services' // Google Services Gradle plugin
    
    // Apply the Crashlytics Gradle plugin
    apply plugin: 'com.google.firebase.crashlytics'
        

3단계: Crashlytics 초기화

  1. Firebase Android BoM을 사용하여 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에서 Crashlytics Android 라이브러리의 종속 항목을 선언합니다.

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

    비정상 종료가 발생하지 않은 사용자와 탐색경로를 실시간으로 확인하려면 BoM v24.7.1 이상의 버전을 사용해야 합니다.

    자바

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.5.0')
    
        // Declare the dependencies for the Crashlytics and Analytics libraries
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-crashlytics'
        implementation 'com.google.firebase:firebase-analytics'
    }
    

    Firebase Android BoM을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (대안) BoM을 사용하지 않고 Firebase 라이브러리 종속 항목을 선언합니다.

    Firebase BoM을 사용하지 않도록 선택한 경우에는 종속 항목 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

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

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.5.0')
    
        // Declare the dependencies for the Crashlytics and Analytics libraries
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-crashlytics-ktx'
        implementation 'com.google.firebase:firebase-analytics-ktx'
    }
    

    Firebase Android BoM을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (대안) BoM을 사용하지 않고 Firebase 라이브러리 종속 항목을 선언합니다.

    Firebase BoM을 사용하지 않도록 선택한 경우에는 종속 항목 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

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

  2. 선택사항: Firebase Crashlytics는 Android Native Development Kit(NDK)를 사용하여 빌드한 앱의 비정상 종료 보고를 제공합니다. 앱에서 NDK를 사용하는 경우 앱의 기본 NDK 라이브러리에서 발생하는 비정상 종료를 보고하도록 Crashlytics를 구성할 수 있습니다. 자세한 내용은 NDK 오류 보고 문서를 참조하세요.

4단계: 프로젝트 실행

마지막으로 앱을 실행합니다. 기기 로그에 초기화가 완료되었다는 Firebase 알림이 표시됩니다.

다음 단계