Firebase Crashlytics を使ってみる

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

始める前に

Crashlytics を設定する前に、Firebase を使用するように iOS アプリを登録して構成する必要があります。

iOS アプリですでに Firebase を使用している場合、この登録と構成はすでに行われています。
iOS アプリがない場合は、サンプルアプリをダウンロードできます。

これらの初期設定作業の詳細については、iOS アプリに Firebase を追加するをご覧ください。

Firebase を iOS アプリに追加するには、Firebase コンソールと開いている Xcode プロジェクトの両方でタスクを行う必要があります（コンソールから Firebase 構成ファイルをダウンロードし、それを Xcode プロジェクトに移動するなど）。

注: Fabric Crashlytics を使っている方は、代わりに移行フローに従ってください。このページでは、Crashlytics を初めて設定する方法について説明します。アプリですでに Fabric Crashlytics を使用していて、Firebase Crashlytics に移行する場合は、便利で使いやすい Fabric の移行フローをご利用ください。

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

Firebase コンソールの左側のナビゲーションパネルにある [Crashlytics] をクリックします。
Firebase プロジェクトに複数のアプリが登録されている場合は、コンソールの上部バーにある [Crashlytics] の横にあるプルダウンから追加したアプリを選択します。
[Crashlytics を設定] をクリックします。
[このアプリでは Crashlytics を初めて使用します（SDK のいずれのバージョンもインストールされていません）] を選択します。

ステップ 2: Crashlytics SDK を追加する

まず始めに、Crashlytics SDK フレームワークファイルをプロジェクトの Xcode ワークスペースに追加します。ほとんどのプロジェクトでは、Crashlytics CocoaPods を追加するのが最も簡単な方法です。ただし、プロジェクトが CocoaPods をサポートできない場合は、ファイルを手動で追加することもできます。

CocoaPods を介してフレームワークを追加する

新しいターミナルウィンドウを開き、Xcode プロジェクトのディレクトリに移動します。

Podfile を開き、強調表示されている行を追加します。

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'MyProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for PodTest
pod 'Fabric', '~> 1.10.2'
pod 'Crashlytics', '~> 3.13.4'

# (Recommended) Pod for Google Analytics
pod 'Firebase/Analytics'
end

CocoaPods が互換性のあるバージョンを見つけることができないというエラーが表示された場合は、次のコマンドを実行します。
```
pod repo update
```
ターミナルで、ポッドの依存関係をインストールします。
```
pod install
```

フレームワークを手動で追加する

Crashlytics SDK をダウンロードします。
SDK を解凍してから、Crashlytics.framework と Fabric.framework をプロジェクトのプロジェクトナビゲータにドラッグします。
[Copy items if necessary] が選択されていることを確認して、[Finish] をクリックします。

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

追加したフレームワークには、Crashlytics を初期化する実行スクリプトが含まれています。それをプロジェクトのビルドフェーズに追加します。

Xcode でプロジェクトを開き、ナビゲータでプロジェクトファイルを選択します。
[Select a project or target] プルダウンでメインのビルドターゲットを選択します。
ターゲットの [Build Phases] タブを開きます。
[+ Add a new build phase] をクリックし、[New Run Script Phase] を選択します。
[Type a script] テキストボックスに次の行を追加します。
CocoaPods インストール
```
"${PODS_ROOT}/Fabric/run"
```
手動インストール
```
"${PROJECT_DIR}/Fabric.framework/run"
```
Xcode 10 のみ: アプリがビルドされた Info.plist の場所をビルドフェーズの [Input Files] フィールドに追加します。
```
$(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)
```
SDK をアプリに追加すると、Crashlytics が自動的にクラッシュレポートをリッスンして収集するようになります。

注: 新しいビルドフェーズがプロジェクトの最後のビルドフェーズであることを確認してください。それ以外の場合は、Crashlytics が正しく初期化されません。

ステップ 4: プロジェクトをビルドまたは実行する

アプリを実行して、Firebase の統合に成功したという確認を Firebase に送信します。

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

動画チュートリアルを視聴する

Crashlytics を使用する際の詳しいガイダンスについては、以下の動画チュートリアルをご覧ください。

Firebase の YouTube チャンネルにはさらに多くの動画があります。

次のステップ

実装をテストする - 強制的にクラッシュさせて Firebase コンソールでクラッシュレポートを生成することにより、Crashlytics の設定をテストします。
クラッシュレポートをカスタマイズする - SDK を追加すると Crashlytics はすぐ自動的にクラッシュレポートの収集を開始します。設定をカスタマイズして、オプトインのレポート、ログ、キーを追加したり、重大でないエラーを追跡したりすることもできます。