Capacitor アプリ用の Firebase Crashlytics

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

Crashlyticsの使用方法
- リアルタイムでクラッシュアラートを受け取る 自動的な問題グループ化機能で詳細なクラッシュレポートを分析する.
- アプリの安定性を維持するために、重要なエラーを監視する セットアップ要件:.
- インストール
Node.js
- (v16+) protectedTokens targetLanguage, 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 用必須)

プラットフォーム構成ファイル

For iOS:

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

__CAPGO_KEEP_0__からファイルをダウンロードしてください。

ファイルの両方、プロジェクトレベルとアプリレベルを変更してください。 google-services.json をダウンロードしてください。
ファイルの両方、プロジェクトレベルとアプリレベルを変更してください。 build.gradle をダウンロードしてください。
アップデート AndroidManifest.xml __CAPGO_KEEP_0__に必要な権限を含める

Firebase コンソール設定

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

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

Firebaseプロジェクトを作成し、クラッシュリポーティングを有効化 Firebaseコンソールでアプリを登録
Firebaseコンソールでアプリを登録 Cloudflare
- bundle ID を使用 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'
```

インストール手順

Plugin Installation

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

まず、プラグインをインストールし Capacitorと同期する:

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の設定

アプリのレベル 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を確認する。

カスタムキーを使用してテストクラッシュをトリガーする:

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のクラッシュリポーティングセクションでクラッシュレポートを探すことができます。ここでは、以下のような情報が見られます。

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

問題を詳しく調べるには、クラッシュが発生したユーザーの詳細情報を表示するには、クラッシュをクリックしてください。スタックトレース、デバイス情報（OSバージョン、メモリ）、カスタムキー、ログ、クラッシュが発生するまでのユーザーの行動などが表示されます。

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

エラーマネジメントのヒント

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

Protecting User Privacy

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

Permissions:
- プライバシーポリシーでクラッシュレポートを記載する必要があります。
- GDPR規制地域のユーザーからデータ収集の同意を取得する必要があります。
- クラッシュレポートからのユーザー脱退オプションを提供する必要があります。

データ収集の制御:

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

データ保持期間:
- 90 日間で自動的にデータを削除するように設定します。
- レポートから敏感情報を消去します。
- デバッグ中にユーザーのプライバシーを維持するために、非識別可能なカスタムキーを使用します。

Capgo 統合

Capgo Live Update ダッシュボードインターフェイス

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

About Capgo

Capgo は、 Capacitor アプリのライブアップデートツールです。1,900 を超えるアプリが運用中で、24 時間以内に 95% のアップデート率を実現し、迅速な修正を実現するのに役立ちます。 [1].

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

端末間の暗号化 安全な更新用
1クリックで前のバージョンに戻す ターゲットリリース用のチャネルベースの配布
CI/CD統合 A
100%オープンソースのプラットフォーム
Crashlyticsと__CAPGO_KEEP_0__の組み合わせ Crashlyticsと__CAPGO_KEEP_0__を使用すると、問題を迅速に特定して解決するための効率的なワークフローが作成されます。

Crashlytics and Capgo Together

Using Crashlytics with Capgo creates an efficient workflow for identifying and resolving issues quickly.

これがどうやって動くか:

クラッシュ検出と対応
クラッシュリクライアントはクラッシュを検出し、Capgo を使用して即時修正を展開できます。アプリストアの承認を待つ必要はありません。
ターゲットアップデート
- :特定のグループでテストして、効果が確認できるようにします。ステージドロールアウト
- :リスクを軽減するために、徐々にアップデートを展開します。緊急修正
- :緊急問題を解決するために、重要なパッチを迅速にプッシュします。監視と検証
アップデートを展開した後、クラッシュリクライアントを使用してクラッシュ率を追跡し、問題が解決したことを確認します。
クラッシュリクライアントはクラッシュを検出し、Capgo を使用して即時修正を展開できます。アプリストアの承認を待つ必要はありません。

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

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

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

Crashlyticsとの安全な統合のために:

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

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

プラグインオプション

エラーを報告するプラグインを適切に選択することは、エラーを特定して修正するアプリのパフォーマンスに大きな影響を与える。

ここでは、CapacitorのためのCrashlyticsと他の人気のエラーレポートツールの比較を簡単に紹介します。

センチネル: 無料のレベルと、$26/月の有料プランから始まる。30を超えるプラットフォームをサポートし、詳細なコンテキストと共にリアルタイムのエラーモニタリングを提供します。
バグスナグ: $47/月から始まります。モバイルとウェブの両方のプラットフォームをカバーし、自動的なエラーグループ化とリリーストラッキングを特徴としています。
ロールバック: $31/月から始まります。複数のプラットフォームをサポートし、デプロイメントトラッキングや人々のトラッキングなどの機能を提供します。

Capacitorは、Firebaseをすでに使用しているチームにとって、Smoothな統合と無料のレベルを提供するため、Crashlyticsは特に魅力的な選択肢です。

概要

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

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

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

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

これらのツールを統合する理由は何ですか?

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

Reliable rollouts更新が広く採用され、ユーザーにSmoothに配信されることを保証します。
IntegrateIntegrate

次のステップは?

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

クラッシュリポーティングとCapgoを導入すると、長期にわたってアプリを安定させて改善する準備が整います。