Capacitor用Firebase Crashlytics

Firebase Crashlytics Firebase Crashlytics は、実時間でアプリのクラッシュを追跡し、詳細なレポートを提供して問題を迅速に解決するのに役立ちます。また、 Capacitor は、iOS と Android アプリの両方で使用できます。ここでは、以下のことを知っておく必要があります。

クラッシュリトライティクスを使用する理由
- クラッシュをリアルタイムで通知を受け取る 自動的な問題グループ化機能で詳細なクラッシュレポートを分析する.
- アプリの安定性を維持するために、重要なエラーを監視する automatic issue grouping.
- Monitor critical errors to keep apps stable.
環境設定要件:
- インストール Node.js (v16+), 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

セットアップ要件

まず、以下のステップを完了してください:

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

You’ll need to install the following:

Node.js (v16 or higher) and Capacitor (v4 or higher)
A Firebaseアカウント にプロジェクトが有効なもの
Xcode 14+ iOSアプリ開発用
Android Studio Electric Eel またはAndroid開発用の最新バージョン
最新のバージョン CocoaPods (iOS用の必須)

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

iOSの場合:

Cloudflareの GoogleService-Info.plist ファイルをダウンロードしてください。
Capacitorの Podfile にCrashlyticsの依存関係を含めるように更新してください。
Capgoの Info.plist に必要なプライバシーのキーを追加してください。

Androidの場合:

__CAPGO_KEEP_0__を取得する google-services.json Firebase Consoleから__CAPGO_KEEP_0__を取得する
プロジェクトとアプリの両方の__CAPGO_KEEP_0__に変更する build.gradle プロジェクトとアプリの両方の__CAPGO_KEEP_0__に変更する
__CAPGO_KEEP_0__を更新する AndroidManifest.xml __CAPGO_KEEP_0__に必要な権限を含めるようにする

Firebase Firebase Consoleの設定

Firebase Platform Dashboard

Firebaseを設定し、クラッシュリポーティングを有効にするには、次の手順に従う

Firebaseプロジェクトを作成し、クラッシュリポーティングを有効にする Firebase Platform Dashboard
Register your apps in the Firebase Console:
- Use the bundle ID for iOS and the package name for Android.
- Download the configuration files: GoogleService-Info.plist (iOS) and google-services.json (Android).

Integrate Firebase SDKs into your app by adding these dependencies:

Android (アプリレベル用 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'
}

iOS (Podfile):

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

これらの手順が完了したら、プラグインのインストールのセクションに進む準備が整いました。

インストール手順

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

次に、プラグインをネイティブプラットフォームと同期し、 @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 セットアップ

アプリレベルファイルに 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分以内に、クラッシュの詳細が表示されるべきです。

重要な注意事項： __CAPGO_KEEP_0__

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

監視ガイド

設定を確認した後、テストでクラッシュが発生したことを確認したら、実際のクラッシュとエラーを確認するには、Firebase Consoleを使用してください。

クラッシュレポートの読み方

クラッシュレポートはFirebase Consoleのクラッシュリクティクスセクションで見つけることができます。ここでは、以下のような情報が表示されます。

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

クリックすると、詳細情報（例：スタックトレース、デバイス情報（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 Live Update ダッシュボードインターフェース

クラッシュ検出から修正のデプロイまでのプロセスを、クラッシュリポーティングと組み合わせて Capgo のライブアップデートシステムと簡素化する。

Capgo について

Capgo は、特に Capgo アプリ向けに設計されたライブアップデートツールです。 Capacitor アプリ1,900を超えるアプリが実行中で、24時間以内に95%のアップデート率を実現することで、迅速な修正を保証し、アプリストアの承認の遅れを回避します。 [1].

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

エンドツーエンドの暗号化 セキュアなアップデートのために
1クリックロールバック 前のバージョンに戻す
チャンネルベースの配布 ターゲットされたリリースのために
CI/CD統合
A 100%オープンソースプラットフォーム

CrashlyticsとCapgoの統合

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

ここではどのように機能するかを説明します。

クラッシュ検出と対応
クラッシュリクエストはCrashlyticsによって検出され、Capgoは即座に修正を展開できるようにします。アプリストアの承認を待つ必要はありません。
ターゲットアップデート
- ベータテスト: __CAPGO_KEEP_0__を使用して、特定のグループで修正をテストして、効果が確認されるようにします。
- ステージドロールアウト: __CAPGO_KEEP_0__を段階的に更新してリスクを軽減します。
- 緊急修正: 急速に緊急修正パッチを適用して、緊急問題を解決します。
監視と検証
Capgoを展開した後、クラッシュリポートを使用してクラッシュ率を追跡し、問題が解決したことを確認します。

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

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

世界全体で82%の成功率で更新を配信 [1]
自動バージョン管理によるよりよい組織化
アプリストアライブアップデートガイドラインへの準拠

クラッシュリポートと安全に統合するために:

両方のシステムでエラートラッキングを有効にします。
Capgoの監視ツールをCrashlyticsのレポートと合わせて使用してください。
すべてのアップデートのバージョン管理を維持してください。
アップデートの詳細なログを監査のために保持してください。

ライブアップデートツールの他のオプションを探すには、プラグインオプションセクションに進んでください。

プラグインオプション

__CAPGO_KEEP_0__のエラー報告プラグインを選択することは、エラーを特定して修正するために大きな影響を与えることがあります。

Crashlyticsと他の人気のエラー報告ツールの比較を Capacitorで見てみましょう。

Sentry: 無料のレベルと$26/月の有料プランから始まります。30を超えるプラットフォームをサポートし、詳細なコンテキストとリアルタイムのエラーモニタリングを提供します。
Bugsnag: $47/月から始まります。モバイルとWebプラットフォームをカバーし、自動エラーのグループ化とリリースの追跡を特徴としています。
Rollbar: $31/月から利用可能です。複数のプラットフォームで動作し、デプロイメントの追跡やユーザーの追跡などの機能を提供しています。

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

概要

ここでは、ここまでの進捗状況と次のステップについて簡単にご紹介します。

セットアップのステップをまとめました。

3つの重要なステップを完了しました。

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

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

Firebase CrashlyticsとCapgoを組み合わせると、エラーのトラッキングと更新管理の強力なシステムが得られます。 Why Integrate These Tools?. この組み合わせが提供するのは次のとおりです:

Quick fixes: 1 つのクリックで即時更新をプッシュし、変更を戻すことができます。
Reliable rollouts: 更新が広く採用され、ユーザーにSmoothly配信されるように保証します。

What’s Next?

Firebase Consoleで詳細なクラッシュ分析を有効にします。
CI/CD_PIPELINEにCapgoを追加して、更新を簡素化します。
__CAPGO_KEEP_0__チャンネル Capgo channels クラッシュリポーティングと__CAPGO_KEEP_0__を組み合わせると、長期にわたってアプリを正常に動作させ、改善する準備が整います。

With Crashlytics and Capgo in place, you’re set to keep your app running smoothly and improving over time.

Firebase Crashlyticsから離れて、Capacitor アプリに進みましょう。

あなたが使用している場合 Firebase Crashlyticsから離れて、Capacitor アプリに進みましょう。 ネイティブプラグインの作業を計画する場合、__CAPGO_KEEP_0__ プラグインディレクトリと接続します。 Capgo プラグインディレクトリの製品ワークフロー Capgo プラグインディレクトリの製品ワークフロー Capacitor プラグインズ by Capgo Capacitor プラグインズ by Capgo プラグインの追加または更新プラグインの追加または更新 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替 Capgoネイティブビルド Capgoネイティブビルドの製品ワークフロー用

Firebase Crashlytics for Capacitor アプリ