Capacitor アプリ用の Firebase Crashlytics

Firebase Crashlytics リアルタイムでアプリのクラッシュを追跡し、詳細なレポートを提供して問題を迅速に修正するのに役立ちます。 Capacitor iOSおよびAndroidアプリの両方に対応するため、以下の情報をご確認ください。

Crashlyticsを使用する理由
- リアルタイムでクラッシュアラートを受け取る 自動的な問題グループ化機能で詳細なクラッシュレポートを分析する.
- アプリの安定性を維持するために、重要なエラーを監視する セットアップ要件.
- インストール
Node.js
- (v16+) Why Use Crashlytics? Get real-time crash alerts, Capacitor (v4+),およびツール類 Xcode 14+ および Android Studio Electric Eel.
- ダウンロード Firebase 構成ファイル（GoogleService-Info.plist iOS用 google-services.json Android用）。
- プラットフォーム固有のファイルを更新する Podfile (iOS)と build.gradle (Android).

重要なステップ:

Crashlyticsをインストール:

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

アプリにCrashlyticsを初期化:

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

セットアップをテスト:
- テストクラッシュをトリガー:
```
await FirebaseCrashlytics.crash();
```
ボーナスチップ: Crashlyticsを Capgo と組み合わせて、即時ライブ更新をアプリストアの遅延なしで実現します。

このガイドでは、アプリがクラッシュせずユーザーフレンドリーであることを保証します。Firebase Crashlyticsのセットアップを始めてみましょう!

2021 Android ガイド: Firebase Crashlytics - カスタムクラッシュ …

Firebase Crashlytics

セットアップ要件

始める前に、以下のステップを完了してください:

必要なソフトウェアとアカウント

次のものをインストールする必要があります:

Node.js (v16 またはそれ以上) と Capacitor (v4 以上)
A Firebaseアカウント プロジェクトが有効なもの
Xcode 14以上 iOS開発用
Android Studio Electric Eel またはAndroid開発用の最新バージョン
最新版の CocoaPods (iOS用必須)

プラットフォーム設定ファイル

iOS向け:

ファイルを GoogleService-Info.plist Firebase Consoleからダウンロードしてください。
を更新してください。Crashlytics依存関係を含めるようにします。 Podfile 必要なプライバシーキーを追加してください。ファイル。
Android向け: Info.plist ファイルをFirebase Consoleから取得してください。

プロジェクトレベルとアプリレベル両方のファイルを変更してください。

ファイルを google-services.json ファイルを
ファイルを build.gradle ファイルを
を更新してください AndroidManifest.xml __CAPGO_KEEP_0__に必要な権限を含めるようにします。

Firebase コンソール設定

Firebase Platform ダッシュボード

Firebaseを設定し、クラッシュリポーティングを有効化するには、以下の手順に従ってください。

Firebaseプロジェクトを作成し、クラッシュリポーティングを有効化します。 Firebaseコンソールでアプリを登録します:
を使用してアプリを登録します。 Bundle ID
- Firebase Console Firebase Platform iOSとAndroidの両方に対応する パッケージ名 Android用の
- 設定ファイルをダウンロード: GoogleService-Info.plist (iOS)と google-services.json (Android).

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__

プラグインのインストール

次に、プラグインをネイティブプラットフォームと同期し、 @capgo/capacitor-firebase-crashlytics プラグインの詳細なAPIのリファレンスはこちら:

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

次に、Crashlyticsをアプリに初期化します。次のcodeをアプリに追加してください: app.component.ts または main.ts:

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

プラットフォームの設定

AndroidとiOSのプラットフォームの必要な設定を設定します。

Androidの設定

アプリのレベルGradleファイルにCrashlytics Gradle プラグインを追加してください: build.gradle ファイル:

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

クラッシュの収集を有効にします AndroidManifest.xml:

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

iOS セットアップ

Firebase を設定する AppDelegate.swift:
```
import Firebase
FirebaseApp.configure()
```

セットアップをテストする

Crashlytics が正常に動作していることを確認するには、テストクラッシュを実行し、Firebase Console を確認する:

テストクラッシュをカスタムキーでトリガーする:

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 を使用します。

エラー報告の読み取り

__CAPGO_KEEP_0__でエラー報告を確認できます。CrashlyticsセクションのFirebaseコンソールで参照してください。

クラッシュフリーのユーザー: クラッシュが発生していないユーザーの割合
問題の安定性: クラッシュが発生する頻度
影響分析: クラッシュが発生したユーザーの数

詳細を表示

: スタックトレース、デバイス情報（OSバージョン、メモリ）、カスタムキー、ログ、クラッシュの原因となるユーザーの行動を確認できます。プロのヒント

: クラッシュ率が突然増加したときに通知を受けたい場合は、「速度の警告」機能を有効にしてください。これにより、問題を解決する前に多くのユーザーに影響を与える前に、問題を迅速に解決できます。

影響度を優先する: 最もユーザーに影響を与えるクラッシュやアプリの重要な部分で発生するクラッシュに焦点を当てましょう。トレンドを追跡することで、緊急の問題を特定できます。
カスタムキーを使用する: クラッシュレポートにカスタムキーを追加して、コンテキストを追加しましょう。例えば:
```
await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});
```
類似する問題をグループ化する: Firebaseの自動的な問題グループ化を活用しましょう。関連するクラッシュを一貫したカスタムキーでタグ付けし、簡単に追跡できるように明確で説明的なタイトルを使用できます。

ユーザーのプライバシー保護

ユーザーのデータを保護し、規制遵守を確実にするために、以下のガイドラインを参照してください。

許可:
- プライバシーポリシーでクラッシュレポートを記載する
- GDPR規制地域でデータ収集の許可をユーザーに取得する
- クラッシュレポートのオプトアウト機能をユーザーに提供する

データ収集制御:

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

データ保持:
- 90 日間で自動的にデータを削除してください。
- レポートから敏感情報を消去してください。
- デバッグ中にユーザーのプライバシーを維持するために、非特定のカスタムキーを使用してください。

Capgo 統合

Capgo ライブアップデートダッシュボードインターフェイス

クラッシュ検出から修正のデプロイまでのプロセスを、クラッシュリクエストと組み合わせてCapgoのライブアップデートシステムを使用して、効率化してください。

About Capgo

Capgoは、 Capacitorアプリ用に設計されたライブアップデートツールです1,900を超えるアプリが実行中で、24時間以内に95%の更新率を実現することで、即時修正が可能になり、ストアの承認待ちの遅延を回避します [1].

主な機能は次のとおりです

端末間の暗号化 安全な更新のために
1クリックで前のバージョンに戻す バージョン
ターゲット化されたリリースのために CI/CDのシームレスな統合
100%オープンソースのプラットフォーム
Crashlyticsと__CAPGO_KEEP_0__の統合 __CAPGO_KEEP_0__は__CAPGO_KEEP_0__です.

CapgoはCapgoです.

Capgoで使用することで、Crashlyticsは問題の特定と解決を迅速に実現する効率的なワークフローを提供します。

以下の説明をご覧ください。

クラッシュ検出と対応
クラッシュリクエストはクラッシュリクエストで、Capgoは即時修正を可能にし、アプリストアの承認を待つ必要がなくなります。
ターゲットアップデート
- ベータテスト: ご指定のグループでテストを実施し、修正の効果を確認します。
- ステージドロールアウト: 危険性を最小限に抑えるために、更新を段階的に展開します。
- 緊急修正: 急速に緊急修正を展開し、問題を解決します。
監視と検証
After Capgoをデプロイした後は、クラッシュリポーティングを使用してクラッシュ率を追跡し、問題が解決されていることを確認してください。

セキュリティとアプリストアの規則

Capgoは、AppleとGoogleのポリシーに準拠しながら、強力なセキュリティ機能を提供しています。

82％のグローバル成功率でアップデートを配信 [1]
自動バージョン管理によるよりよい組織
アプリストアのライブアップデートガイドラインへの準拠

クラッシュリポーティングとの安全な統合のために:

両方のシステムでエラー追跡を有効にします。
Capgoの監視ツールをクラッシュリポーティングのレポートと共に使用します。
すべてのアップデートのバージョン管理を維持します。
アップデートの詳細なログを監査目的で保持します。

ライブアップデートツールの他のオプションを探すには、プラグインオプションセクションに進みます。

プラグインの設定

エラーを特定して修正するには、正しいクラッシュレポートプラグインを選択することが大切です。

Here’s a quick comparison of Crashlytics with other popular error-reporting tools for Capacitor:

Sentry: 無料のプランが用意されており、有料のプランは月額 26 ドルから始まります。30 を超えるプラットフォームをサポートし、詳細なコンテキストと共にリアルタイムのエラーモニタリングを提供します。
Bugsnag: 月額 47 ドルから始まります。モバイルとウェブの両方のプラットフォームをカバーし、自動的なエラーグループングとリリースの追跡を特徴としています。
Rollbar: 月額 31 ドルから始まります。複数のプラットフォームをサポートし、デプロイメントの追跡と人々の追跡などの機能を提供します。

Capacitor では、Firebase を使用するチームにとって Crashlytics は特に魅力的です。なぜなら、Smooth な統合と無料のプランが用意されているからです。

概要

ここでは、達成したことと次のステップを簡単に確認できます。

セットアップステップの概要

あなたは、始めるために3つの重要なステップを完了しました:

Firebaseプロジェクトを作成し、iOS/Androidアプリを登録しました。
クラッシュリポーティングプラグインをインストールおよび設定しました。
必要なiOSおよびAndroidプラットフォームファイルを更新しました。

これらのツールを統合する理由

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and Quick fixes: 1クリックで即時更新をプッシュし、変更を戻すことができます。

信頼できるロールアウトupdate管理
update管理: __CAPGO_KEEP_0__を幅広く採用し、ユーザーにSmoothに配信するようにします。

What’s Next?

Firebase Consoleで詳細なクラッシュ分析を有効にします。
CapgoをCI/CD pipelineに追加して、更新をStreamlinedにします。
Use Capgoチャンネルを使用して、修正をステップバイステップでテストしてリリースします。

CrashlyticsとCapgoを導入すると、長期にわたってアプリをSmoothに運営し、改善する準備が整います。