Firebase Crashlytics 시작하기

이 빠른 시작에서는 Firebase 콘솔에서 포괄적인 오류 보고서를 확인할 수 있도록 Firebase Crashlytics를 설정하는 방법을 설명합니다.

iOS

Android

Unity[베타]

시작하기 전에

iOS

시작하려면 Firebase Crashlytics가 사용 설정된 Firebase 앱이 필요합니다.

Android

시작하려면 Firebase Crashlytics가 사용 설정된 Firebase 앱이 필요합니다.

Unity[베타]

Crashlytics를 사용하려면 Unity 프로젝트를 등록하고 Firebase를 사용하도록 구성해야 합니다.

  • Unity 프로젝트에서 현재 Firebase를 사용하고 있다면 이미 등록되어 Firebase용으로 구성된 것입니다.

  • Unity 프로젝트가 없는 경우 샘플 앱을 다운로드할 수 있습니다.

Unity 프로젝트에 Firebase를 추가할 때 Firebase 콘솔 및 열려 있는 Unity 프로젝트 모두에서 작업을 수행해야 합니다. 예를 들어 콘솔에서 Firebase 구성 파일을 다운로드한 후 이 파일을 Unity 프로젝트로 이동하는 작업이 필요합니다.

Firebase 콘솔에서 Crashlytics 설정

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

  2. Firebase 프로젝트에 여러 앱이 등록되어 있으면 콘솔 상단 표시줄의 Crashlytics 옆에 있는 드롭다운에서 새 Unity 프로젝트를 선택합니다.

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

  4. Crashlytics를 처음 사용하는 앱이며 설치된 SDK 버전이 없습니다.를 선택합니다.

프로젝트에 Crashlytics SDK 추가

iOS

1. Xcode 작업공간에 Crashlytics 프레임워크 추가

시작하려면 프로젝트에 Crashlytics SDK 프레임워크 파일을 추가합니다. 대부분의 프로젝트에서 가장 쉬운 추가 방법은 Crashlytics CocoaPods를 추가하는 것이지만 프로젝트에서 CocoaPods를 지원할 수 없다면 파일을 직접 추가할 수도 있습니다.

2. Crashlytics 실행 스크립트 추가

추가한 프레임워크에는 Crashlytics를 초기화하는 실행 스크립트가 포함되어 있습니다. 프로젝트의 빌드 단계에 이 스크립트를 추가하세요.

  1. Xcode에서 프로젝트를 열고 탐색기에서 해당 프로젝트 파일을 선택합니다.
  2. 프로젝트 또는 대상 선택 드롭다운에서 기본 빌드 대상을 선택합니다.
  3. 대상의 빌드 단계 탭을 엽니다.
  4. + Add a new build phase를 클릭하고 New Run Script Phase를 선택합니다.
  5. Type a script... 입력란에 다음 줄을 추가합니다.
    CocoaPods 설치
    "${PODS_ROOT}/Fabric/run"
    직접 설치
    "${PROJECT_DIR}/Fabric.framework/run"
  6. Xcode 10에만 해당: 앱의 빌드한 Info.plist 위치를 빌드 단계의 입력 파일 필드에 추가합니다.
    $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

앱에 SDK를 추가하면 Crashlytics가 자동으로 오류 보고서를 수신 대기하고 수집하기 시작합니다.

Android

빌드 파일에 SDK 포함

  1. 프로젝트 수준 build.gradle에서 google-services 버전을 3.1.2 이상으로 업데이트하고 Crashlytics 저장소와 종속 항목을 추가합니다.

    buildscript {
        repositories {
            // ...
    
            // Add repository
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms:google-services:4.2.0'
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.26.1'
        }
    }
    
    allprojects { // ... repositories { // ... // Add repository maven { url 'https://maven.google.com/' } } }

  2. 앱 수준 build.gradle에서 firebase-core를 v11.4.2 이상으로 업데이트하고 Crashlytics 종속 항목을 추가합니다.

    apply plugin: 'com.android.application'
    apply plugin: 'io.fabric'
    
    dependencies { // ... // Check for v11.4.2 or higher implementation 'com.google.firebase:firebase-core:16.0.7' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.9' }

앱에 SDK를 추가하면 Crashlytics가 자동으로 오류 보고서를 리슨하고 수집하기 시작합니다.

Unity[베타]

1단계: Crashlytics 패키지 추가

  1. Firebase Unity SDK를 다운로드한 다음, 원하는 위치에 SDK의 압축을 풉니다.

    Firebase Unity SDK는 플랫폼별로 제공되지 않습니다.

  2. Unity 프로젝트를 열고 애셋 > 패키지 가져오기 > 맞춤 패키지로 이동합니다.

  3. 압축을 푼 SDK에서 Crashlytics SDK(FirebaseCrashlytics.unitypackage) 가져오기를 선택합니다.

    다른 지원 Firebase 서비스를 가져올 수도 있습니다.

  4. Unity 패키지 가져오기 창에서 가져오기를 클릭합니다.

2단계: Crashlytics 초기화

  1. 새 C# 스크립트를 만들어 장면의 GameObject에 추가합니다.

    1. 첫 번째 장면을 연 다음, 이름이 GameObject인 빈 CrashlyticsInitializer를 만듭니다.

    2. 새 객체에 대해 검사기에서 구성요소 추가를 클릭합니다.

    3. CrashlyticsInit 스크립트를 선택하여 CrashlyticsInitializer 객체에 추가합니다.

  2. 스크립트의 Start 메소드에서 Crashlytics를 초기화합니다.

      using System.Collections;
      using System.Collections.Generic;
      using UnityEngine;
    
      // Import Firebase
      using Firebase;
    
      public class CrashlyticsInit : MonoBehaviour {
          // Use this for initialization
          void Start () {
              // Initialize Firebase
              Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                  var dependencyStatus = task.Result;
                  if (dependencyStatus == Firebase.DependencyStatus.Available)
                  {
                      // Create and hold a reference to your FirebaseApp,
                      // where app is a Firebase.FirebaseApp property of your application class.
                      // Crashlytics will use the DefaultInstance, as well;
                      // this ensures that Crashlytics is intitialized.
                      Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                      // WARNING: Do not call Crashlytics APIs from asynchronous tasks;
                      // they are not currently supported.
    
                      // Set a flag here for indicating that your project is ready to use Firebase.
                  }
                  else
                  {
                      UnityEngine.Debug.LogError(System.String.Format(
                        "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                      // Firebase Unity SDK is not safe to use here.
                  }
              });
          }
    
        // Update is called once per frame
        void Update()
          // ...
      }

SDK를 추가하고 초기화하면 Crashlytics는 자동으로 오류 보고서를 수신 대기하고 수집하기 시작합니다.

3단계: 프로젝트 빌드

프로젝트를 iOS 또는 Android로 내보낸 후 올바르게 내보냈는지 확인합니다.

프로젝트를 아래의 내보내기 구성 샘플과 비교한 후 파일이 누락된 것 같으면 Unity 편집기를 연 다음 Google Play 서비스 리졸버를 실행합니다.

iOS

Android

리졸버 실행(선택사항)

Google Play 서비스 리졸버 실행:

Google Play 서비스 리졸버는 Unity 프로젝트에 앱을 iOS 또는 Android로 내보내기 위한 적절한 종속 항목이 있는지 확인합니다.

리졸버에 대한 자세한 내용은 Unity Jar Resolver의 README를 참조하세요.

iOS

iOS 리졸버는 자동으로 실행되고 Cocoapods를 활용하여 내보낸 Pods 디렉토리에 iOS 종속 항목을 넣습니다.

  • 머신에 Cocoapods를 다운로드하는 방법은 다음과 같습니다.

    • 애셋 > Play 서비스 리졸버 > iOS 리졸버 > CocoaPods 설치로 이동합니다.
  • Podfile 생성을 사용 설정하거나 중지하는 방법은 다음 안내를 따르세요(선택사항).

    • 애셋 > Play 서비스 리졸버 > iOS 리졸버 > 설정으로 이동합니다.

Android

Android 리졸버는 자동으로 실행되고 gradle을 활용하여 Assets/Plugins/Android에 Android 종속 항목을 넣습니다.

  • 리졸버를 직접 실행하는 방법은 다음과 같습니다.

    • 애셋 > Play 서비스 리졸버 > Android 리졸버 > 확인으로 이동합니다.
  • 자동 확인을 사용 설정하거나 중지하는 방법은 다음과 같습니다. 기본적으로 사용 설정되어 있습니다.

    • 애셋 > Play 서비스 리졸버 > Android 리졸버 > 설정으로 이동합니다.

동영상 가이드 보기

iOS

Crashlytics 시작에 대한 자세한 안내는 다음 동영상 자습서를 참조하세요.

그 밖에도 많은 동영상을 Firebase YouTube 채널에서 확인할 수 있습니다.

Android

Crashlytics 시작에 대한 자세한 안내는 다음 동영상 자습서를 참조하세요.

그 밖에도 많은 동영상을 Firebase YouTube 채널에서 확인할 수 있습니다.

다음 단계

  • 구현 테스트 - 강제 비정상 종료를 통해 Crashlytics 설정을 테스트하여 Firebase 콘솔에 오류 보고서를 생성합니다.

  • 오류 보고서 맞춤설정 - SDK를 추가하는 즉시 Crashlytics에서 자동으로 오류 보고서 수집을 시작하지만 보고 선택 옵션, 로그, 키를 추가하고 심각하지 않은 오류를 추적하여 설정을 맞춤설정할 수도 있습니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.