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

Firebase Crashlytics 시작하기

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

시작하기 전에

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

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

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

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

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

1단계: Firebase Console에서 Crashlytics 설정

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

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

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

2단계: 앱에 Firebase Crashlytics SDK 추가

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

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

  2. Unity 프로젝트를 열고 Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(커스텀 패키지)로 이동합니다.

  3. 압축을 푼 SDK에서 Crashlytics SDK(FirebaseCrashlytics.unitypackage)를 선택하여 가져옵니다.

    다른 지원되는 Firebase 제품도 가져올 수 있습니다.

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

3단계: Crashlytics 초기화

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

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

    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 initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // 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는 자동으로 오류 보고서를 수신하고 수집하기 시작합니다.

4단계: 프로젝트 실행

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

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

iOS

Android

리졸버 실행(선택사항)

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

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

iOS

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

  • 머신에 CocoaPods를 다운로드하려면 다음을 따르세요.

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

    • Assets(애셋) > Play Services Resolver(Play 서비스 리졸버) > iOS Resolver(iOS 리졸버) > Settings(설정)로 이동합니다.

Android

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

  • 리졸버를 직접 실행하려면 다음을 따르세요.

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

    • Assets(애셋) > Play Services Resolver(Play 서비스 리졸버) > Android Resolver(Android 리졸버) > Settings(설정)로 이동합니다.

5단계: 테스트 비정상 종료를 강제로 적용하여 설정 완료

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

이 방법에 대한 자세한 내용은 구현 테스트를 참조하세요.

다음 단계