Firebase Crashlytics for Capacitor 앱

Firebase Crashlytics 실시간으로 앱 충돌을 추적하고, 문제를 빠르게 해결할 수 있는 세부 보고서를 제공합니다. 또한 Capacitor iOS와 Android용 앱에 완벽하게 통합됩니다. 이에 대해 알아야 할 사항은 다음과 같습니다.

• Crashlytics를 사용하는 이유

  • 실시간으로 앱 충돌 알림을 받으세요 실시간 앱 충돌 알림을 받으세요.
  • 세부적인 충돌 보고서를 분석하여 자동 문제 그룹화.
  • 중요한 오류를 모니터링하여 앱을 안정적으로 유지합니다.

• 설정 요구 사항:

  • 설치 Node.js (v16+), Capacitor (v4+), 그리고 Xcode 14+ 및 Android Studio 전기 전차.
  • 다운로드 파이어베이스 __CAPGO_KEEP_0__ (GoogleService-Info.plist iOS용 google-services.json Android용 ).
  • 플랫폼에 따라 파일을 업데이트하십시오: Podfile (iOS) build.gradle (Android).

• 주요 단계:

  • 크래시 리포팅을 설치하십시오:

    npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

  • 앱에서 크래시 리포팅을 초기화하십시오:

    import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
    await FirebaseCrashlytics.initialize();

• 설정 테스트:

  • 테스트 충돌을 트리거하세요:

    await FirebaseCrashlytics.crash();

• 보너스 팁: Firebase Crashlytics와 Capgo 앱 스토어 지연 없이 즉시 실시간 업데이트

이 안내서로 앱이 충돌이 없고 사용자 친화적인지 확인하세요. Firebase Crashlytics를 오늘부터 설정하세요!

2021 안드로이드 가이드: Firebase Crashlytics - 사용자 지정 충돌 …

설치 요구 사항

먼저 다음 단계를 완료하십시오:

필요한 소프트웨어 및 계정

다음 것을 설치해야 합니다:

• Node.js (v16 이상)과 Capacitor (v4 이상)
• Firebase 계정 활성 프로젝트와 함께 Xcode 14+
• iOS 개발을 위해
• Android Studio Electric Eel Android 개발을 위해 최신 버전
• 최신 버전의 CocoaPods (iOS를 위해 필요)

플랫폼 구성 파일

iOS:

• Firebase 콘솔에서 GoogleService-Info.plist 업데이트하여
• 에 크래시 리틱스 의존성을 포함하도록 Podfile Crashlytics 의존성을 포함하도록
• 개인 정보 키를 필요로 하는 파일에 추가하세요. Info.plist __CAPGO_KEEP_0__.

Android:

• __CAPGO_KEEP_0__ 파일을 Firebase Console에서 가져옵니다. google-services.json Firebase Console에서
• 프로젝트 수준과 앱 수준의 build.gradle 파일을 모두 수정하세요.
• __CAPGO_KEEP_0__을 업데이트하여 필요한 권한을 포함하세요. AndroidManifest.xml Firebase

Console 설정 Firebase 플랫폼 대시보드

Firebase를 설정하고 Crashlytics를 활성화하기 위한 단계를 따르세요:

1. Firebase 프로젝트를 생성하세요 그리고 Crashlytics를 활성화하세요.

2. 앱을 Firebase Console에 등록하세요: iOS에서는 "bundle ID"를 사용하고 Android에서는 "package name"를 사용하세요.

   • 설정 파일을 다운로드하세요: iOS에서는 Android에서는 Firebase Console에서 Firebase Console
   • Firebase Console GoogleService-Info.plist Firebase Console google-services.json (Android)

3. Firebase SDK를 앱에 통합하기 위해 다음 의존성을 추가하세요: Android (앱 수준)

   iOS ( build.gradle):

   dependencies {
       implementation platform('com.google.firebase:firebase-bom:32.0.0')
       implementation 'com.google.firebase:firebase-crashlytics'
       implementation 'com.google.firebase:firebase-analytics'
   }

   이러한 단계가 완료되면 플러그인 설치 섹션으로 넘어가세요.Podfile):

   pod 'Firebase/Crashlytics'
   pod 'Firebase/Analytics'

설치 단계

플러그인 설치

먼저 플러그인을 설치하고 __CAPGO_KEEP_0__와 동기화하세요.

그런 다음 앱에서 Crashlytics를 초기화하세요. 다음 __CAPGO_KEEP_0__를 추가하세요. sync it with Capacitor:

npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

Then, initialize Crashlytics in your app. Add the following code to app.component.ts into your app by adding these dependencies: main.ts:

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

플랫폼 설정

Android 및 iOS 플랫폼에 필요한 설정을 구성하세요.

Android 설정

1. 앱 수준 gradle 파일에 Crashlytics Gradle 플러그인을 추가하세요. build.gradle 파일:

   buildscript { 
       dependencies { 
           classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
       } 
   }
   apply plugin: 'com.google.firebase.crashlytics'

2. 사고 수집을 활성화하세요. AndroidManifest.xml:

   <meta-data
       android:name="firebase_crashlytics_collection_enabled"
       android:value="true" />

iOS 설정

1. Firebase를 구성하세요. AppDelegate.swift:

   import Firebase
   FirebaseApp.configure()

설정 테스트

사고 리포팅이 정상 작동하는지 확인하려면 Firebase 콘솔에서 테스트 사고를 확인하세요.

• 사고를 트리거하려면 사용자 지정 키를 사용하세요.

  await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'});
  await FirebaseCrashlytics.crash();

• 사용자를 식별하려면 선택적으로 사용하세요.

  await FirebaseCrashlytics.setUserId({userId: 'user123'});

• 사용자 이벤트 로그

  await FirebaseCrashlytics.log({message: 'Test crash triggered'});

Firebase Console에 약 5분 이내에 스택 추적, 장치 정보 및 사용자 정의 키가 포함된 보고서가 표시되어야 합니다.

중요: 앱을 출시하기 전에 크래시 호출을 제거하세요. 개발 중에 크래시 수집을 비활성화하려면 다음을 사용하세요:

await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});

모니터링 가이드

테스트 크래시를 확인한 후에 실제 앱에서 발생하는 크래시 및 오류를 추적하기 위해 Firebase Console을 사용하세요.

크래시 보고서 읽기

Firebase Console의 Crashlytics 섹션에서 크래시 보고서를 찾을 수 있습니다. 여기서 볼 수 있는 내용은 다음과 같습니다:

• 크래시 없는 사용자: 사용자가 크래시를 경험하지 않은 사용자 비율
• : 크래시가 발생하는 빈도Crash-free users: __CAPGO_KEEP_0__
• 영향 분석: 사용자에게 영향을 미친 사용자의 수입니다.

상세한 스택 트레이스, 장치 정보 (예: OS 버전, 메모리), 사용자 정의 키, 로그 및 사용자가 충돌로 인해 발생한 여행을 확인하려면 충돌을 클릭하세요.

프로 팁: 충돌률이 suddenly 증가하면 알림을 받을 수 있도록 '속도 알림' 기능을 활성화하세요. 이 기능은 문제를 해결하기 전에 충돌이 많은 사용자에게 영향을 미치지 않도록 도와줍니다.

오류 관리 팁

• 우선순위 설정: 사용자에게 가장 많은 영향을 미치는 충돌이나 앱의 중요한 부분에서 발생하는 충돌에 집중하세요. 트렌드 추적은 급박한 문제를 식별하는 데 도움이 됩니다.

• 사용자 정의 키 사용: 충돌 보고서에 사용자 정의 키를 추가하여 더 많은 정보를 제공하세요. 예를 들어:

  await FirebaseCrashlytics.setCustomKey({
    key: 'current_view',
    value: 'payment_processing'
  });

• 유사한 문제 그룹화: Firebase의 자동 문제 그룹화 기능을 사용하세요. 또한 일관된 사용자 정의 키와 명확하고 설명적인 제목을 사용하여 관련된 충돌을 태그하고 추적하세요.

사용자 개인정보 보호

__CAPGO_KEEP_0__

• 권한:

  • 사용자 개인정보 보호 정책에 충돌 보고를 포함하세요.
  • GDPR 규정 적용 지역에서 데이터 수집에 대한 사용자 동의를 얻으세요.
  • 충돌 보고에 대한 사용자 옵트아웃 기능을 제공하세요.

• 데이터 수집 제어:

  await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
  await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});

• 데이터 보유 기간:

  • 90일 후 자동으로 데이터를 삭제하세요.
  • 보고서에서敏感 정보를 삭제하세요.
  • 사용자 개인정보 보호를 유지하면서 디버깅을 위해 사용자 고유 키를 사용하세요.

Capgo 통합

Capgo의 Live Update 시스템을 Crashlytics와 Pair하여 오류 감지부터修정 배포까지의 프로세스를 단순화하세요.

Capgo에 대해

Capgo는 Capgo 앱을 위한 Live Update 도구로 설계되었습니다. Capacitor 앱. __CAPGO_KEEP_0__는 1,900개 이상의 앱이 운영 중이며, 24시간 이내에 95%의 업데이트율을 보장하여 앱 스토어 승인 지연 없이 빠른 수정을 보장합니다. [1].

__CAPGO_KEEP_0__의 주요 기능은 다음과 같습니다.

• 끝에서 끝까지 암호화된 업데이트 안전한 업데이트
• 한 번 클릭으로 이전 버전으로 롤백 이전 버전으로 롤백
• 채널 기반 배포 대상별 릴리즈
• 무결합 CI/CD 통합
• A 100% 오픈 소스 플랫폼

Capgo과 Crashlytics

Capgo과 Crashlytics를 사용하면 문제를 신속하게 식별하고 해결할 수 있는 효율적인 워크플로를 생성합니다.

이것은 어떻게 작동하는가?

1. 에러 감지 및 대응
   에러 감지는 Crashlytics가 수행하고 Capgo은 앱 스토어 승인 기다리지 않고 즉시 수정을 배포할 수 있도록 합니다.

2. 대상별 업데이트

   • 베타 테스트: __CAPGO_KEEP_0__을 위한 특정 그룹으로 테스트하여 효과가 있는지 확인합니다.
   • 스테이지드 롤아웃: 업데이트된 위험을 줄이기 위해 점진적으로 배포합니다.
   • 비상수리: 긴급한 문제를 해결하기 위해 빠르게 중요 패치를 푸시합니다.

3. 모니터링 및 확인
   : Capgo을 통해 업데이트를 배포한 후, 크래시 리포트를 사용하여 크래시율을 추적하고 문제가 해결되었는지 확인합니다.

보안 및 앱 스토어 규칙

Capgo은 Apple과 Google의 정책을 준수하면서 강력한 보안 기능을 제공합니다:

• 업데이트 배포 성공률 82% [1]
• 자동 버전 관리를 통한 더 나은 조직
• 앱 스토어 라이브 업데이트 지침 준수

안전한 통합을 위해 Crashlytics와의 통합을 위해:

• 두 시스템 모두에서 오류 추적을 활성화하십시오.
• Capgo의 모니터링 도구와 Crashlytics 보고서를 함께 사용하십시오.
• 모든 업데이트를 관리하십시오.
• 업데이트에 대한 세부 로그를 유지하기 위해 감사 목적으로:

Plugin Options 섹션으로 이동하여 다른 실시간 업데이트 도구를 탐색하십시오.

Plugin Options

오류를 식별하고 수정하는 데 있어 앱에 영향을 미치는 오류 보고 플러그인 선택은 매우 중요합니다.

Capacitor에서 Crashlytics와 다른 인기 있는 오류 보고 도구의 빠른 비교:

• Sentry: 무료 티어를 제공하며 26달러/월의 유료 계획부터 시작하여 30개 이상의 플랫폼을 지원하며, 세부적인 맥락과 함께 실시간 오류 모니터링을 제공합니다.
• Bugsnag: $47/월에 시작합니다. 모바일 및 웹 플랫폼을 모두 지원하며 자동 오류 그룹화 및 릴리스 추적 기능을 제공합니다.
• Rollbar: $31/월에 시작합니다. 여러 플랫폼에서 작동하며 배포 추적 및 사용자 추적 기능을 제공합니다.

Crashlytics는 Firebase를 사용하는 팀에게 특히 매력적입니다. smooth한 통합과 무료 티어를 제공합니다.

Summary

이제까지 무엇을 accomplished했는지 그리고 다음 단계는 무엇인지 간단하게 살펴보세요:

Setup Steps Recap

3개의 중요한 단계를 완료했습니다:

• Firebase 프로젝트를 생성하고 iOS/Android 앱을 등록했습니다.
• Crashlytics 플러그인을 설치하고 설정했습니다.
• 필요한 iOS 및 Android 플랫폼 파일을 업데이트했습니다.

이러한 도구를 통합하는 이유는 무엇입니까?

파이어베이스 크래시 리트리빙과 Capgo을 pairing하면 오류 추적 및 업데이트 관리를 위한 강력한 시스템을 제공합니다. 업데이트 관리. 이 콤보가 제공하는 것은 다음과 같습니다:

• 빠른 수정: 즉시 업데이트 및 변경 사항을 되돌리기 위해 단지 한 번 클릭으로.
• 신뢰할 수 있는 롤아웃: 업데이트가 사용자에게 널리 채택되고MOOTH하게 전달되도록 보장합니다.

다음 단계

1. 파이어베이스 콘솔에서 세부적인 크래시 분석을 활성화하세요.
2. Capgo을 CI/CD pipeline에 추가하여 업데이트를 단순화하세요.
3. __CAPGO_KEEP_0__ 채널을 사용하세요. Capgo channels 단계별로 테스트하고 수정을 릴리즈하세요.

크래시 리포팅과 Capgo이 설정된 후, 앱이 원활하게 작동하고 시간이 지남에 따라 개선되도록 준비되어 있습니다.