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

Firebase Crashlytics 시작하기

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

시작하기 전에

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

  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 프로젝트용으로 만든 podfile을 열고 FirebaseCrashlytics pod를 추가합니다.

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

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. pod를 설치하고 .xcworkspace 파일을 다시 열어 Xcode에서 프로젝트를 확인합니다.

    pod install
    open your-project.xcworkspace
    
  3. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. 일반적으로 앱의 application:didFinishLaunchingWithOptions: 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

    Swift

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    Objective-C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. 앱을 다시 컴파일합니다.

3단계: Crashlytics 초기화

프로젝트의 빌드 단계에 실행 스크립트를 추가하여 Crashlytics를 초기화할 수 있습니다. 실행 스크립트를 사용하면 앱이 비정상 종료될 때마다 Xcode에서 프로젝트의 dSYM 파일을 자동으로 업로드하므로 Crashlytics가 자동으로 오류 보고서를 생성할 수 있습니다.

  1. Xcode에서 프로젝트를 열고 왼쪽 탐색기에서 프로젝트 파일을 선택합니다.

  2. Select a project or target(프로젝트 또는 대상 선택) 드롭다운에서 기본 빌드 대상을 선택합니다.

  3. Build Phases(빌드 단계) 탭을 선택한 다음 > New Run Script Phase(새 실행 스크립트 단계)를 클릭합니다.

  4. 표시되는 새 Run Script(실행 스크립트) 섹션을 펼칩니다. Shell(셸) 필드 아래에 있는 스크립트 필드에서 새 실행 스크립트를 추가합니다.

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. 앱의 dSYM 위치를 입력 파일로 추가하면 Crashlytics에서 대용량 앱의 dSYM을 더 빠르게 자동으로 생성할 수 있습니다. 예를 들면 다음과 같습니다.

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    빌드 단계의 Input Files(입력 파일) 필드에 앱의 빌드된 Info.plist 위치를 제공할 수도 있습니다.

    $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

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

4단계: 프로젝트 실행

앱을 실행합니다. 기기 로그에 초기화가 완료되었다는 Firebase 확인이 표시되어야 합니다.

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

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

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

다음 단계