Capacitor アプリ用の Firebase Crashlytics

Firebase Crashlytics リアルタイムでアプリのクラッシュを追跡し、詳細なレポートを提供して問題を迅速に解決するのに役立ちます。 Capacitor iOSおよびAndroidアプリの両方に対応するため、以下のことを知っておく必要があります。

Crashlyticsを使用する理由
- リアルタイムでクラッシュアラートを受け取る 自動的な問題グループ化機能で詳細なクラッシュレポートを分析する.
- アプリの安定性を維持するために、重要なエラーを監視する セットアップ要件:.
- Node.jsをインストールする
(v16+)
- Install __CAPGO_KEEP_0__ __CAPGO_KEEP_0__, 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 or higher)
A Firebaseアカウント 有効なプロジェクト
Xcode 14+ iOS開発用
Android Studio Electric Eel またはAndroid開発用の最新バージョン
The latest version of CocoaPods (iOS用必須)

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

For iOS:

をダウンロードしてください。 GoogleService-Info.plist __CAPGO_KEEP_0__からファイルをダウンロードしてください。
__CAPGO_KEEP_0__を更新して、クラッシュリポーティング依存関係を含めるようにしてください。 Podfile __CAPGO_KEEP_0__に必要なプライバシーキーを追加してください。
For Android: Info.plist __CAPGO_KEEP_0__からファイルをダウンロードしてください。

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

Update your __CAPGO_KEEP_0__ to include Crashlytics dependencies. google-services.json Add the necessary privacy keys to your __CAPGO_KEEP_0__.
Make changes to both the project-level and app-level __CAPGO_KEEP_0__ files. build.gradle Obtain the __CAPGO_KEEP_0__ file from the Firebase Console.
を更新して AndroidManifest.xml __CAPGO_KEEP_0__に必要な権限を含める

Firebase コンソール設定

Firebaseプラットフォームダッシュボード

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

Firebaseプロジェクトを作成し、クラッシュリポーティングを有効化 Firebaseコンソールでアプリを登録
Firebaseコンソールでアプリを登録 を使用して
- バンドルID Firebaseのクラッシュリポーティングを有効化するには、以下の手順に従ってください。 iOSとAndroid用 __CAPGO_KEEP_0__ 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()
```

セットアップのテスト

__CAPGO_KEEP_0__が正常に機能していることを確認するには、テストクラッシュを実行し、Firebase Console を確認します。

__CAPGO_KEEP_0__でテストクラッシュをトリガーするには、カスタムキーを使用します。

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

__CAPGO_KEEP_0__を使用してユーザーを特定することができます。
```
await FirebaseCrashlytics.setUserId({userId: 'user123'});
```

カスタムイベントを記録することができます。

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

Firebase Console に、スタックトレース、デバイスの詳細、およびカスタムキーが含まれるレポートが、約 5 分以内に表示されます。

重要: __CAPGO_KEEP_0__を削除する必要があります。開発用にクラッシュコレクションを無効にするには、使用してください。

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%オープンソースのプラットフォーム
クラッシュリポーティングと __CAPGO_KEEP_0__
Crashlyticsと __CAPGO_KEEP_0__ Crashlyticsと __CAPGO_KEEP_0__

Crashlyticsと Capgo

Capgoを使用してCrashlyticsと統合すると、問題を迅速に特定して解決するための効率的なワークフローが作成されます。

以下の手順に従ってください。

クラッシュ検出と対応
Crashlyticsがクラッシュを検出すると、Capgoは即時で修正を展開できるようにします。アプリストアの承認を待つ必要はありません。
ターゲットアップデート
- ベータテスト: ご指定のグループで修正をテストして、効果が確認できるようにします。
- ステージドロールアウト: 危険性を軽減するために、徐々にアップデートを展開します。
- 緊急修正: 急速に緊急修正を展開して、緊急問題を解決します。
監視と検証
アップデートを 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 ドルから始まります。複数のプラットフォームをサポートし、デプロイメントトラッキングやユーザートラッキングなどの機能を提供します。

Capgo の場合、Firebase を使用しているチームには、Smooth な統合と無料のプランが特に魅力的です。

概要

ここでは、達成したことと次のステップについての簡単なまとめをご覧いただけます。

セットアップステップのまとめ

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

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

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

CapgoとFirebase Crashlyticsを組み合わせると、エラートラッキングと更新管理の強力なシステムが得られます。ここでは、この組み合わせが提供するものを紹介します。 Quick fixes: 1クリックで即時更新をプッシュし、変更を戻すことができます。

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

What’s Next?

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

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

Firebase Crashlytics for Capacitor Appsから続けてください。

あなたがFirebase Crashlytics for __CAPGO_KEEP_0__ Appsを使用してNativeプラグインの作業を計画している場合、Cloudflareに接続する必要があります。 あなたがFirebase Crashlytics for Capacitor Appsを使用している場合、Capacitorに接続する必要があります。 あなたがFirebase Crashlytics for __CAPGO_KEEP_0__ Appsを使用している場合、GitHubに接続する必要があります。 Capgo プラグインディレクトリ Capgo プラグインディレクトリの製品ワークフローについて Capacitor プラグインは Capgo によって提供されます Capacitor プラグインの実装詳細については Capgo を参照してくださいプラグインの追加または更新プラグインの追加または更新の実装詳細についてはこちら Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフローについて Capgo ネイティブビルド Capgo ネイティブビルドの製品ワークフローについて