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

Firebase Crashlytics 시작하기

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

Crashlytics를 설정하려면 Firebase Console과 IDE 모두에서 작업을 수행해야 합니다(예: Firebase 구성 파일 및 Crashlytics SDK 추가). 설정을 완료하려면 테스트 비정상 종료를 강제로 적용하여 첫 번째 비정상 종료 보고서를 Firebase로 전송해야 합니다.

시작하기 전에

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

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

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

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

1단계: Firebase Console에서 Crashlytics 사용 설정

  1. Firebase Console의 Crashlytics 대시보드로 이동합니다.

  2. 페이지 상단의 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];
    

3단계: Xcode를 설정하여 dSYM 파일 자동 업로드

사람이 읽을 수 있는 비정상 종료 보고서를 생성하려면 Crashlytics에 프로젝트의 디버그 기호(dSYM) 파일이 필요합니다. 다음 단계에서는 dSYM을 자동으로 생성하고 처리한 후 앱을 빌드할 때마다 파일을 업로드하도록 Xcode를 구성하는 방법을 설명합니다.

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

  2. TARGETS(대상) 목록에서 기본 빌드 대상을 선택합니다.

  3. Build Settings(빌드 설정) 탭을 클릭한 후 다음 단계를 완료하여 Xcode에서 빌드에 사용할 dSYM을 생성하도록 합니다.

    1. All(모두)을 클릭한 후 debug information format을 검색합니다.

    2. 모든 빌드 유형의 Debug Information Format(디버그 정보 형식)DWARF with dSYM File(dSYM 파일로 DWARF)로 설정합니다.

  4. Build Phases(빌드 단계) 탭을 클릭한 후 다음 단계를 완료하여 Xcode에서 dSYM을 처리하고 파일을 업로드할 수 있도록 합니다.

    1. > New Run Script Phase(새 실행 스크립트 단계)를 클릭합니다.

      이 새로운 Run Script(실행 스크립트) 단계가 프로젝트의 마지막 빌드 단계인지 확인합니다. 그렇지 않으면 Crashlytics가 dSYM을 제대로 처리할 수 없습니다.

    2. 새로운 Run Script(실행 스크립트) 섹션을 펼칩니다.

    3. Shell(셸) 라벨 아래에 있는 스크립트 필드에서 실행 스크립트를 추가합니다.

      이 스크립트는 프로젝트의 dSYM 파일을 처리하고 파일을 Crashlytics에 업로드합니다.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. Input Files(입력 파일) 섹션에서 다음 파일의 경로를 추가합니다.

      • 프로젝트의 dSYM 파일에 경로를 추가합니다.

        그러면 Crashlytics에서 대용량 앱의 dSYM을 더 빠르게 처리할 수 있습니다.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • 프로젝트의 빌드된 Info.plist 파일에 경로를 추가합니다.

        그러면 Crashlytics에서 앱 버전을 dSYM과 연결할 수 있습니다.

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

dSYM 파일을 수동으로 업로드하는 방법을 비롯해 dSYM 파일 및 Crashlytics에 관한 자세한 내용은 가독화된 비정상 종료 보고서 받기를 참조하세요.

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

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

  1. 테스트 비정상 종료를 강제로 적용하는 데 사용할 수 있는 코드를 앱에 추가합니다.

    다음 코드를 사용하여 누르면 비정상 종료를 일으키는 버튼을 앱에 추가할 수 있습니다. 버튼에 'Test Crash'라는 라벨이 지정되어 있습니다.

    Swift

    import UIKit
    
    class ViewController: UIViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
    
          // Do any additional setup after loading the view, typically from a nib.
    
          let button = UIButton(type: .roundedRect)
          button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
          button.setTitle("Test Crash", for: [])
          button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
          view.addSubview(button)
      }
    
      @IBAction func crashButtonTapped(_ sender: AnyObject) {
          let numbers = [0]
          let _ = numbers[1]
      }
    }
    

    Objective-C

    #import "ViewController.h"
    
    @implementation ViewController
    ‐ (void)viewDidLoad {
        [super viewDidLoad];
    
        // Do any additional setup after loading the view, typically from a nib.
    
        UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
        button.frame = CGRectMake(20, 50, 100, 30);
        [button setTitle:@"Test Crash" forState:UIControlStateNormal];
        [button addTarget:self action:@selector(crashButtonTapped:)
            forControlEvents:UIControlEventTouchUpInside];
        [self.view addSubview:button];
    }
    
    ‐ (IBAction)crashButtonTapped:(id)sender {
        @[][1];
    }
    
    @end
    
  2. Xcode에서 앱을 빌드하고 실행합니다. 테스트 기기 또는 시뮬레이터가 Crashlytics를 방해하는 Xcode 디버거에서 연결 해제되었는지 확인하려면 다음 단계를 따르세요.

    1. Build and then run the current scheme(현재 스키마 빌드 후 실행)을 클릭하여 테스트 기기 또는 시뮬레이터에서 앱을 빌드합니다.

    2. 앱이 실행될 때까지 기다린 다음 Stop running the scheme or action(스키마 또는 작업 실행 중지)을 클릭하여 앱의 최초 인스턴스를 종료합니다. 이 최초 인스턴스는 Crashlytics를 방해하는 디버거를 포함합니다.

  3. 앱의 첫 번째 비정상 종료 보고서를 전송하려면 테스트 비정상 종료를 강제로 적용합니다.

    1. 테스트 기기 또는 시뮬레이터의 홈 화면에서 앱을 엽니다.

    2. 앱에서 위 코드를 사용하여 추가한 'Test Crash' 버튼을 누릅니다.

    3. 앱이 비정상 종료된 후에는 Xcode에서 앱을 다시 실행하여 앱에서 비정상 종료 보고서를 Firebase에 전송할 수 있도록 합니다.

  4. Firebase Console의 Crashlytics 대시보드로 이동하여 테스트 비정상 종료를 확인합니다.

    Console을 새로고침하고 5분 후에도 테스트 비정상 종료가 표시되지 않으면 디버그 로깅을 사용 설정하여 앱에서 비정상 종료 보고서를 전송하는지 확인합니다.


이제 모든 작업이 완료되었습니다. 이제 Crashlytics에서 앱의 비정상 종료를 모니터링합니다. Crashlytics 대시보드에서 비정상 종료 보고서와 통계를 확인하고 조사할 수 있습니다.

다음 단계