이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Firebase Crashlytics 시작하기

이 빠른 시작에서는 앱에서 Firebase Crashlytics를 설정하는 방법을 설명합니다. Firebase Crashlytics SDK로 통합하면 종합적인 비정상 종료 발생률과 보고서를Firebase 콘솔에서 확인할 수 있습니다.

Crashlytics를 설정하려면 Firebase 콘솔 및 IDE (예: Firebase 구성 파일 및 Crashlytics 합니다. 설정을 완료하려면 테스트 비정상 종료를 강제로 적용하여 첫 번째 비정상 종료 보고서를 Firebase로 전송해야 합니다.

시작하기 전에

아직 추가하지 않았다면 Apple 프로젝트에 Firebase를 추가합니다. Apple 앱이 없다면 샘플 앱을 다운로드하면 됩니다.
권장: 자동으로 탐색경로 로그 비정상 종료, 심각하지 않은 문제, ANR 이벤트로 이어지는 사용자 작업을 이해하고 Firebase 프로젝트에서 Google Analytics를 사용 설정해야 합니다.
- 기존 Firebase 프로젝트에 Google Analytics가 없는 경우 Google Analytics를 사용 설정하면 Integrations 탭 > 프로젝트 설정 Firebase 콘솔에서 확인할 수 있습니다.
- 새 Firebase 프로젝트를 만드는 경우 Google Analytics를 사용 설정합니다. 프로젝트 생성 워크플로에서 작성할 수 있습니다
탐색경로 로그는 watchOS를 제외한 Crashlytics입니다. <ph type="x-smartling-placeholder"></ph>

1단계: 앱에 Crashlytics SDK 추가

Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.

앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

  https://github.com/firebase/firebase-ios-sdk.git

Crashlytics 라이브러리를 선택합니다.
GCP의 탐색경로 로그, 또한 앱에 Google Analytics용 Firebase SDK를 추가합니다. 그런 다음 Google 애널리틱스가 사용 설정됨 확인할 수 있습니다
타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC 플래그를 추가합니다.
(macOS만 해당) Info.plist에서 키를 추가합니다. NSApplicationCrashOnExceptions로 설정하고 다음으로 설정 YES입니다.
완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

그런 다음 Firebase 모듈을 구성합니다.

App 구조체 또는 UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
일반적으로 앱의 application(_:didFinishLaunchingWithOptions:) 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.
Swift
```
// Use the Firebase library to configure APIs.
FirebaseApp.configure()
```
Objective-C
```
// Use the Firebase library to configure APIs.
[FIRApp configure];
```

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

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

프로젝트의 Xcode 작업공간을 열고 왼쪽 탐색기에서 프로젝트 파일을 선택합니다.
TARGETS(대상) 목록에서 기본 빌드 대상을 선택합니다.
Build Settings(빌드 설정) 탭을 클릭한 후 다음 단계를 완료하여 Xcode에서 빌드에 사용할 dSYM을 생성하도록 합니다.
1. All(모두)을 클릭한 후 debug information format을 검색합니다.
2. 모든 빌드 유형의 Debug Information Format(디버그 정보 형식)을 DWARF with dSYM File로 설정합니다.
Build Phases(빌드 단계) 탭을 클릭한 후 다음 단계를 완료하여 Xcode에서 dSYM을 처리하고 파일을 업로드할 수 있도록 합니다.
1. > New Run Script Phase(새 실행 스크립트 단계)를 클릭합니다.
  
  이 새로운 Run Script 단계가 프로젝트의 마지막 빌드인지 확인합니다. 단계 그러지 않으면 Crashlytics에서 dSYM을 제대로 처리할 수 없습니다.
2. 새로운 Run Script(실행 스크립트) 섹션을 펼칩니다.
  
  참고: 나머지 하위 단계에서는 해당 경로를 정확히 그대로 복사하여 붙여넣으세요. 그러면 Xcode에서 경로를 확인합니다. 단, Xcode에서 이러한 경로 또는 고유한 프로젝트 구조를 확인하는 데 문제가 있는 경우에는 경로를 수동으로 지정할 수 있습니다.
3. Shell(셸) 라벨 아래에 있는 스크립트 필드에서 실행 스크립트를 추가합니다.
  
  이 스크립트는 프로젝트의 dSYM 파일을 처리하고 Crashlytics
```
"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
```
4. Input Files(입력 파일) 섹션에서 다음 파일 위치의 경로를 추가합니다.
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
```
```
$(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
```
```
$(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)
```
  이러한 파일의 위치가 필요한 이유 이해하기
  
  Xcode는 지정된 위치에서 이러한 입력 파일을 찾아 실행 스크립트에 빌드 파일을 사용할 수 있는지 확인합니다. 또한 사용자 스크립트 샌드박스를 사용 설정하면 Xcode는 실행 스크립트가 입력 파일에 지정된 파일에 액세스하는 것만 허용합니다.
  - 프로젝트의 dSYM 파일 위치를 제공하면 Crashlytics: dSYM을 처리합니다.
  - 앱이 빌드된 위치 제공 GoogleService-Info.plist 파일을 통해 Crashlytics가 dSYM을 Firebase 앱
  - 앱의 실행 파일 위치를 제공하면 실행 스크립트가 동일한 dSYM의 중복 업로드를 방지할 수 있습니다. 앱 바이너리는 업로드되지 않습니다.

dSYM 파일 및 Crashlytics( dSYM 파일을 수동으로 업로드하는 방법) 가독화된 비정상 종료 보고서 받기

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

Crashlytics 설정을 완료하고 다음에서 초기 데이터를 확인하려면 Firebase 콘솔의 Crashlytics 대시보드에서 테스트를 강제 실행해야 합니다. 비정상 종료됩니다.

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

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

SwiftUI

Button("Crash") {
  fatalError("Crash was triggered")
}

UIKit

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

Xcode 디버거 연결을 해제한 상태로 Xcode에서 앱을 빌드하고 실행합니다.

Xcode 디버거로 인한 비정상 종료 보고서 차단 Crashlytics(으)로 전송되지 않습니다. 다음 단계를 완료하세요. Xcode 디버거에서 테스트 기기 또는 시뮬레이터의 연결 해제 이전에 확인할 수 있습니다.
1. Build and then run the current scheme(현재 스키마 빌드 후 실행)을 클릭하여 테스트 기기 또는 시뮬레이터에서 앱을 빌드합니다.
2. 앱이 실행될 때까지 기다린 다음 스키마 실행을 중지하거나 action을 사용하여 앱의 초기 인스턴스를 닫습니다. 이 이니셜은 인스턴스에 Crashlytics를 방해하는 디버거가 포함되어 있습니다.
앱의 첫 번째 비정상 종료 보고서를 전송하려면 테스트 비정상 종료를 강제로 적용합니다.
1. 테스트 기기 또는 시뮬레이터의 홈 화면에서 앱을 엽니다.
2. 앱에서 위 코드를 사용하여 추가한 'Test Crash' 버튼을 누릅니다.
3. 앱이 비정상 종료된 후에는 Xcode에서 앱을 다시 실행하여 앱에서 비정상 종료 보고서를 Firebase에 전송할 수 있도록 합니다.
Crashlytics 대시보드로 이동하여 Firebase 콘솔에서 테스트 비정상 종료를 확인하세요.

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

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

다음 단계

보고 선택 옵션, 로그, 키를 추가하고 심각하지 않은 오류를 추적하여 비정상 종료 보고서 설정을 맞춤설정하세요.