파이어베이스 Crashlytics
충돌은 앱 개발에서 피할 수 없는 측면이지만, 원활한 사용자가 경험을 제공하기 위해서는 충돌을 신속하게 식별하고 수정하는 것이 중요하다.
Firebase Crashlytics는 iOS 애플리케이션에서 충돌을 추적하고 분석하기 위한 강력한 솔루션을 제공한다.
Crashlytics 로그란?
•
Firebase에서 크래시 전송 설정을 하면(Firebase Crashlytics와 dSYM 파일 전송), 크래시가 발생한 경우, 크래시 정보를 파이어베이스에 전송
•
기본적인 크래시 정보를 Crashlytics에 보내지만, 크래시가 발생하기 전의 특정한 정보를 알고 싶은 경우, 로그 전송이 가능하다.
Crashlytics 설정
Swift 프로젝트에 Crashlytics를 추가하는 방법
크래시 리포트를 사용자 지정하기 전에 Swift 프로젝트에서 Crashlytics를 설정하는 것이 필수적이다.
1. Firebase 프로젝트 설정
•
Firebase 프로젝트 생성
•
화면의 지시에 따라 iOS 앱을 Firebase 프로젝트에 추가
2. Firebase SDK 설치
pod 'Firebase/Crashlytics'
Swift
복사
3. Firebase 초기화
import Firebase
Swift
복사
AppDelegate의 didFinishLaunchingWithOptions
FirebaseApp.configure()
Swift
복사
4. Crashlytics 활성화
•
XCode → Firebase 콘솔로 이동
•
Crashlytics 섹션에서 iOS앱에 대해 Crashlytics 활성화
dSYM 파일을 자동으로 업로드하도록 XCode 설정
우리가 읽을 수 있는 크래시 리포트를 생성하려면 Crashlytics에 프로젝트의 디버그 심볼(dSYM) 파일이 필요하다.
XCode를 구성하여 dSYM을 자동으로 생성하고 처리하고 앱을 빌드할 때마다 파일을 업로드하는 방법
1.
프로젝트의 XCode 작업 공간을 연다음, 왼쪽 프로젝트 파일 선택
2.
TARGETS 목록에서 기본 빌드 타켓 선택
3.
빌드 설정 탭 클릭 → 다음 단계를 완료하여 XCode가 빌드에 대한 dSYM을 생성하도록 한다.
4.
모두를 클릭한 다음, 디버그 정보 형식을 검색한다.
5.
모든 빌드 유형에 대해 dSYM 파일을 사용하여 디버그 정보 형식을 DWARF로 설정
6.
빌드 단계 탭을 클릭한 다음, 다음 단계를 완료하여 XCode에서 dSYM을 처리하고 파일을 업로드할 수 있도록 함
7.
추가 → 새 실행 스크립트 단계를 클릭
8.
이 새로운 스크립트 실행 단계가 프로젝트의 마지막 빌드 단계인지 확인, 그렇지 않으면 Crashlytics가 dSYM을 제대로 처리할 수 없다.
9.
새로운 스크립트 실행 섹션을 확장
10.
스크립트 필드에 다음 실행 스크립트를 추가, 이 스크립트는 프로젝트의 dSYM 파일을 처리하고 Creashlytics에 파일을 업로드
"${PODS_ROOT}/FirebaseCrashlytics/run"
Swift
복사
11.
입력 파일 섹션에서 다음 파일의 위치에 대한 경로를 추가한다.
${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)
Swift
복사
Build and Run
•
시뮬레이터나 실제 장치에서 앱을 빌드하고 실행
•
테스트 충돌을 강제로 발생시키는데 사용할 수 있는 코드를 앱에 추가한다.
•
초기 Crashlytics 설정이 성공했는지 확인
// SwiftUI
Button("Crash") {
fatalError("Crash was triggered")
}
// UIKit
let arr = [0]
let _ = arr[1]
Swift
복사
Crashlytics 작동 방식
•
Firebase Crashlytics는 iOS 앱에서 자동으로 크래시를 캡처하고 보고하는 방식으로 작동한다.
초기화
•
앱이 시작되면 Crashlytics가 초기화되고 충돌을 모니터링하기 시작한다.
충돌 감지
•
충돌이 발생하면 Crashlytics는 스택 추적 및 기타 관련 정보를 포함한 충돌 데이터를 캡처한다.
데이터 전송
•
Crashlytics는 충돌 데이터를 Firebase 서버로 안전하게 전송한다.
대시보드 프레젠테이션
•
충돌 데이터는 Firebase Crashlytics 대시보드에 표시되며, 이를통해 앱에 영향을 미치는 문제를 분석하고 이해할 수 있다.
Customizing Crash Reports
1.
Import Firebase Crashlytics
import FirebaseCrashlytics
Swift
복사
2.
사용자 정보 설정
•
크래시 리포트에 사용자 정보를 추가하면 특정 사용자 세그먼트에 대한 충돌의 영향을 이해하는데 유용
userID = "12345"
Crashlytics.crashlytics().setUserID(userID)
Swift
복사
3.
Log Custom Events
•
커스텀 이벤트를 로깅하면 유저 상호작용이나 충돌로 이어지는 특정 시나리오에 대한 추가 정보를 제공할 수 있다.
Crashlytics.crashlytics().log("Custom event: User tapped a specific button.")
Swift
복사
4.
Attach Custom Keys
•
크래시 리포트에 커스텀 key-value를 attach하면 특정 정보를 필터링하고 검색할 수 있다.
Crashlytics.crashlytics().setCustomValue("Premium", forKey: "UserType")
// Crashlytics.crashlytics().setCustomValue(UserManager.shared.user.email, forKey: "Email")
Crashlytics.crashlytics().setCustomValue("example@email.com", forKey: "Email")
Crashlytics.crashlytics().setCustomValue("John Doe", forKey: "Name")
Swift
복사
구현 테스트
앱을 릴리즈하기 전에 Crashlytics 구현을 테스트하는 것이 중요하다. 코드에서 충돌을 시뮬레이션하고 커스텀한 정보가 FIrebase Crashlytics 대시보드에 나타나는지 확인한다.
결론
•
Swift iOS 앱에서 Firebase Crashlytics 크래시 리포트를 커스텀하면 문제를 식별, 이해 및 해결하는 능력을 크게 향상시킬 수 있다.
•
커스텀 정보, 커스텀 이벤트 및 key-value 쌍을 통해 컨텍스트를 추가하면 디버깅 프로세스를 간소화하고 유저에게 보다 안정적인 앱을 제공할 수 있다.
