Capacitor アプリ用の Firebase Crashlytics

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

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

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

__CAPGO_KEEP_0__をダウンロードしてください。

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

Firebase コンソール設定

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

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

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

インストール手順

targetLanguage

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

まず、プラグインをインストールし 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コンソールのクラッシュリポーティングセクションでクラッシュレポートを探すことができます。ここでは、以下のような内容が表示されます。

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

問題の詳細を確認するには、クラッシュの任意の問題をクリックしてください。スタックトレース、デバイス情報（OSバージョン、メモリ）、カスタムキー、ログ、クラッシュの原因となったユーザーの行動履歴などを確認できます。

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

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

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

Protecting User Privacy

ユーザーデータを保護し、コンプライアンスを確保するために、以下のガイドラインを参照してください:

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

Data Collection Controls:

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

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

Capgo 統合

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

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

About Capgo

Capgo is a live update tool designed specifically for Capacitor appsのライブアップデートツールです。生産環境で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_KEEP_0__でアップデートを展開してください。
After deploying updates with Capgo, use Crashlytics to track crash rates and confirm the issue is resolved.

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

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

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

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

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

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

プラグインオプション

エラーを検出して修正するには、適切なクラッシュレポートプラグインを選択することが非常に重要です。

Capacitorの他の人気のエラーレポートツールと比較して、Crashlyticsの簡単な比較です。

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

Firebaseを使用しているチームにとって、FirebaseとのSmoothな統合と無料のレベルがCrashlyticsを特に魅力的な選択肢にします。

概要

__CAPGO_KEEP_0__で達成したことの簡単なまとめと、次のステップを確認してください。

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

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

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

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

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

Reliable rollouts更新が広く採用され、ユーザーにSmoothに配信されることを保証します。
これらのツールを統合することで、エラートラッキングと更新管理の強力なシステムが得られます。これらのツールを統合することで、エラートラッキングと更新管理の強力なシステムが得られます。

次のステップは?

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

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