콘솔로 이동

Firebase Crashlytics 시작하기

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

시작하기 전에

Crashlytics를 설정하려면 먼저 iOS 앱을 등록하고 Firebase를 사용하도록 구성해야 합니다.

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

  • iOS 앱이 없다면 샘플 앱을 다운로드하면 됩니다.

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

1단계: Firebase Console에서 Crashlytics 설정

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

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

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

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

2단계: Crashlytics SDK 추가

Crashlytics SDK 프레임워크 파일을 프로젝트의 Xcode 작업공간에 추가하면 됩니다. 대부분의 프로젝트에서 이 작업을 수행하는 가장 쉬운 방법은 Crashlytics CocoaPods를 추가하는 것입니다. 하지만 프로젝트에서 CocoaPods를 지원하지 않는다면 파일을 직접 추가해야 할 수도 있습니다.

3단계: Crashlytics 초기화

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

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

  2. 프로젝트 또는 대상 선택 드롭다운에서 기본 빌드 대상을 선택합니다.

  3. 대상의 빌드 단계 탭을 엽니다.

  4. + 새 빌드 단계 추가를 클릭하고 새로운 실행 스크립트 단계를 선택합니다.

  5. 스크립트 입력 입력란에 다음 줄을 추가합니다.

    CocoaPods 설치
    "${PODS_ROOT}/Fabric/run"
    직접 설치
    "${PROJECT_DIR}/Fabric.framework/run"

  6. Xcode 10만 해당: 앱이 빌드된 Info.plist 위치를 빌드 단계의 입력 파일 필드에 추가합니다.

    $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

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

4단계: 프로젝트 빌드 또는 실행

앱을 실행하여 Firebase를 성공적으로 통합했다는 알림을 Firebase에 보냅니다.

기기 로그에 초기화가 완료되었다는 Firebase 알림이 표시됩니다.

동영상 가이드 보기

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

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

다음 단계

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

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