事前準備
事前に次の環境を準備しておく必要があります。
- Xcode 7.0 以降
- iOS 7 以降をターゲットにした Xcode プロジェクト
- アプリのバンドル識別子
- CocoaPods 1.0.0 以降
- Cloud Messaging の場合:
- 物理 iOS 端末
- プッシュ通知を有効にした APNs 証明書
- Xcode において [アプリケーション] > [機能] でプッシュ通知を有効にする
Xcode プロジェクトをまだ用意していない場合に Firebase 機能を試すだけであれば、クイックスタート サンプルをダウンロードしてご利用いただけます。クイックスタートを使用する場合は、バンドル識別子が次のステップで必要になるため、プロジェクト設定からバンドル識別子を忘れずに取得してください。
アプリに Firebase を追加する
Firebase をアプリに追加するには、Firebase プロジェクトと、アプリ用の Firebase 設定ファイルが必要です。
- Firebase プロジェクトをまだ用意していない場合は、Firebase console で Firebase プロジェクトを作成します。モバイルアプリと関連付けられた既存の Google プロジェクトがある場合は、[Google プロジェクトをインポート] をクリックします。それ以外の場合は、[新規プロジェクトを作成] をクリックします。
- [iOS アプリに Firebase を追加] をクリックして設定手順に沿って操作します。既存の Google プロジェクトをインポートする場合、このステップは自動的に実行されることがあります。その場合は、設定ファイルをダウンロードするだけでかまいません。
- 求められたら、アプリのバンドル ID を入力してください（必ずアプリで使用しているバンドル ID を入力してください）。バンドル ID を設定できるのは、アプリを Firebase プロジェクトに追加するときだけです。
GoogleService-Info.plistファイルをダウンロードします。このファイルはいつでももう一度ダウンロードできます。- このファイルを Xcode プロジェクトのルートにコピーしていない場合はコピーします。
SDK を追加する
新しいプロジェクトを設定する場合は、SDK をインストールする必要があります。 この操作は、Firebase プロジェクトの作成の一環として完了済みの場合があります。
ライブラリをインストールするときは CocoaPods を使用することをおすすめします。インストール手順に沿って CocoaPods をインストールしてください。CocoaPods を使用しない場合は、以下の手順に沿って SDK フレームワークを直接統合する方法もあります。
クイックスタート サンプルをダウンロードしていずれかのプログラムを実行する場合、Xcode プロジェクトと Podfile がすでに存在していても、ポッドをインストールして GoogleService-Info.plist ファイルをダウンロードする必要があります。Firebase ライブラリをプロジェクトに統合する場合は、使用するライブラリ用のポッドを追加する必要があります。
Xcode プロジェクトをまだ用意していない場合は作成します。
Podfileがない場合は作成します。$ cd your-project directory $ pod initインストールするポッドを追加します。次のようにして
Podfileにポッドを含めます。pod 'Firebase/Core'iOS アプリで Firebase を稼動させるために必要な必須のライブラリが、Firebase Analytics とともに追加されます。現在使用可能なポッドとサブスペックのリストを以下に示します。機能固有の設定ガイドへのリンクもあります。
ポッドをインストールし、.xcworkspace ファイルを開いて Xcode でプロジェクトを確認します。
$ pod install $ open your-project.xcworkspaceFirebase console で GoogleService-Info.plist ファイルをダウンロードし、アプリに含めます。
アプリで Firebase を初期化する
最後に、アプリケーションに初期化コードを追加します。この手順は、アプリに Firebase を追加するときにすでに完了している可能性があります。クイックスタートを使用した場合は自動で完了しています。
- Firebase モジュールを
UIApplicationDelegateサブクラスにインポートします。Swift
import Firebase
Objective-C
@import Firebase;
FIRApp共有インスタンスを設定します。通常はアプリケーションのapplication:didFinishLaunchingWithOptions:メソッドを使用します。Swift
// Use Firebase library to configure APIs FIRApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
使用可能なポッド
さまざまな Firebase 機能に使用できるポッドは次のとおりです。
| ポッド | サービス |
|---|---|
| pod 'Firebase/Core' | 必須のライブラリと Analytics |
| pod 'Firebase/AdMob' | AdMob |
| pod 'Firebase/Messaging' | Cloud Messaging / Notifications |
| pod 'Firebase/Database' | Realtime Database |
| pod 'Firebase/Invites' | Invites |
| pod 'Firebase/DynamicLinks' | Dynamic Links |
| pod 'Firebase/Crash' | Crash Reporting |
| pod 'Firebase/RemoteConfig' | Remote Config |
| pod 'Firebase/Auth' | 認証 |
| pod 'Firebase/Storage' | Storage |
CocoaPods を使用せずに統合する
CocoaPods を使用しない場合でも、次の手順でフレームワークを直接インポートすることで Firebase SDK を利用できます。
- フレームワーク SDK の zip ファイルをダウンロードします（100 MB 程度のファイルのため、しばらく時間がかかることがあります）。
- 解凍し、プロジェクトに含めるフレームワークの
READMEファイルを確認します。 - ターゲットのビルド設定で
Other Linker SettingsにObjCリンカーフラグ を追加します。
次のステップ
以下で Firebase の詳細を確認します。
- Firebase アプリのサンプルを確認する。
- Firebase iOS Codelab を使用して実際に体験する。
Firebase 機能をアプリに追加します。
- Analytics を使用してユーザー行動を把握する。
- Authentication を使用してユーザー認証をセットアップする。
- Realtime Database でユーザー情報を保存するか、Cloud Storage で blob データのユーザー情報を保存する。
- Cloud Messaging を使用してユーザーに通知を送信する。
- Crash Reporting を使用してアプリがクラッシュする場所と理由を確認します。
