Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

Firebase Crashlytics を使ってみる

このクイックスタートでは、Firebase コンソールで包括的なクラッシュ レポートを表示できるよう、Firebase Crashlytics SDK を使用してアプリに Firebase Crashlytics を設定する方法について説明します。

始める前に

  1. まだ Firebase を iOS プロジェクトに追加していない場合は追加します。iOS アプリをお持ちでない場合は、サンプルアプリをダウンロードできます。

  2. 推奨: クラッシュに遭遇していないユーザー数の表示、パンくずリストのログ、ベロシティ アラートなどの機能を利用するには、Firebase プロジェクトで Google アナリティクスを有効にする必要があります。

    • 既存の Firebase プロジェクトで Google アナリティクスが有効になっていない場合は、Firebase コンソールで、 > [プロジェクトの設定][統合] タブで Google アナリティクスを有効にします。

    • 新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google アナリティクスを有効にします。

ステップ 1: Firebase コンソールで Crashlytics を設定する

  1. Firebase コンソールの左側のナビゲーション パネルにある [Crashlytics] をクリックします。

  2. Firebase プロジェクトに複数のアプリが登録されている場合は、コンソールの上部バーにある [Crashlytics] の横にあるプルダウンから追加したアプリを選択します。

  3. [Crashlytics を有効にする] をクリックします。

ステップ 2: アプリに Firebase Crashlytics SDK を追加する

  1. Firebase プロジェクト用に作成した podfile を開き、FirebaseCrashlytics ポッドを追加します。

    Crashlytics でのエクスペリエンスを最適化するために、Firebase プロジェクトで Google アナリティクスを有効にして、Google アナリティクス用の Firebase ポッドをアプリに追加することをおすすめします。

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. ポッドをインストールし、.xcworkspace ファイルを再度開いて Xcode でプロジェクトを表示します。

    pod install
    open your-project.xcworkspace
    
  3. Firebase モジュールを UIApplicationDelegate にインポートします。

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. FirebaseApp 共有インスタンスを構成します。通常はアプリの application:didFinishLaunchingWithOptions: メソッドで行います。

    Swift

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    Objective-C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. アプリを再コンパイルします。

ステップ 3: Crashlytics を初期化する

Crashlytics を初期化するには、実行スクリプトをプロジェクトのビルドフェーズに追加します。実行スクリプトを使用すると、アプリがクラッシュするたびに Xcode が自動的にプロジェクトの dSYM ファイルをアップロードするため、Crashlytics は自動的にクラッシュ レポートを生成できます。

  1. Xcode でプロジェクトを開き、左側のナビゲータでプロジェクト ファイルを選択します。

  2. [Select a project or target] プルダウンから、メインのビルド ターゲットを選択します。

  3. [Build Phases] タブを選択し、 > [New Run Script Phase] の順にクリックします。

  4. 表示される [Run Script] セクションを展開します。スクリプト フィールド([Shell] フィールドの下)で、新しい実行スクリプトを追加します。

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. アプリの dSYM の場所を、大規模なアプリに対する Crashlytics の自動 dSYM 生成を高速化する入力ファイルとして追加します。次に例を示します。

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    アプリのビルド済み Info.plist の場所を、ビルドフェーズの [Input Files] フィールドに指定することもできます。

    $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

SDK をアプリに追加すると、Crashlytics が自動的にクラッシュ レポートをリッスンして収集するようになります。

ステップ 4: プロジェクトを実行する

アプリを実行します。デバイスログに、初期化が完了したという Firebase の確認が表示されます。

ステップ 5: 強制的にテスト クラッシュを発生させて設定を完了する

Crashlytics の設定を完了し、Firebase コンソールの Crashlytics ダッシュボードで最初のデータを確認するには、強制的にテスト クラッシュを発生させる必要があります。

詳しい手順については、実装のテストをご覧ください。

次のステップ