前提条件
以下をインストールします。
- Xcode 11.0 以降
- CocoaPods 1.4.0 以降
プロジェクトが次の要件を満たしていることを確認します。
- プロジェクトのターゲットは iOS 8 以降に設定してください。
物理 iOS デバイスを設定するか、iOS シミュレータを使用してアプリを実行します。
- Google アカウントを使用して Firebase にログインします。
作成済みの Xcode プロジェクトがなく、ただ Firebase プロダクトを試してみたいとお考えの方は、クイックスタート サンプルをダウンロードしてお使いください。
ステップ 1: Firebase プロジェクトを作成する
iOS アプリに Firebase を追加する前に、iOS アプリに接続するための Firebase プロジェクトを作成します。Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。
ステップ 2: アプリを Firebase に登録する
Firebase プロジェクトを作成したら、プロジェクトに iOS アプリを追加できます。
Firebase プロジェクトにアプリを追加するベスト プラクティス、考慮事項(複数のビルド バリエーションの扱い方など)の詳細については、Firebase プロジェクトについて理解するをご覧ください。
Firebase コンソールに移動します。
プロジェクトの概要ページの中央にある iOS アイコン(
)をクリックして、設定ワークフローを起動します。すでに Firebase プロジェクトにアプリを追加している場合は、[アプリを追加] をクリックするとプラットフォームのオプションが表示されます。
アプリのバンドル ID を [iOS バンドル ID] フィールドに入力します。
(省略可)その他のアプリ情報(アプリのニックネームと App Store ID)を入力します。
[アプリを登録] をクリックします。
ステップ 3: Firebase 構成ファイルを追加する
[GoogleService-Info.plist をダウンロード] をクリックして、Firebase iOS 構成ファイル(
GoogleService-Info.plist
)を取得します。構成ファイルを Xcode プロジェクトのルートに移動します。メッセージが表示されたら、構成ファイルをすべてのターゲットに追加するオプションを選択します。
プロジェクトに複数のバンドル ID がある場合は、Firebase コンソールで各バンドル ID を登録済みアプリに関連付けて、各アプリで固有の GoogleService-Info.plist
ファイルを使用できるようにする必要があります。
ステップ 4: アプリに Firebase SDK を追加する
Firebase ライブラリのインストールには CocoaPods を使用することをおすすめします。ただし、CocoaPods を使用せずに、SDK フレームワークを直接統合するか、Swift Package Manager(ベータ版)を使用する方法もあります。
クイックスタート サンプルのいずれかを使用していますか?使用している場合は、Xcode プロジェクトと Podfile(ポッドを含む)はすでに存在しますが、Firebase 構成ファイルを追加して、ポッドをインストールする必要があります。
Podfile がない場合は作成します。
cd your-project-directory
pod init
アプリで使用したい Firebase ポッドを Podfile に追加します。
サポートされている Firebase プロダクトを iOS アプリに追加できます。
アナリティクスが有効な場合
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'アナリティクスが無効な場合
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
Pod をインストールし、
.xcworkspace
ファイルを開いて Xcode でプロジェクトを確認します。pod install
open your-project.xcworkspace
ステップ 5: アプリで Firebase を初期化する
最後に、アプリケーションに初期化コードを追加します。この手順は、アプリに Firebase を追加するときにすでに完了している可能性があります。クイックスタートのサンプル プロジェクトを使用した場合は自動で完了しています。
- Firebase モジュールを
UIApplicationDelegate
にインポートします。Swift
import Firebase
Objective-C
@import Firebase;
FirebaseApp
共有インスタンスを構成します。通常はアプリのapplication:didFinishLaunchingWithOptions:
メソッドで行います。Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Firebase 向け Google アナリティクスを追加した場合は、アプリを実行して、Firebase のインストールに成功したという確認を Firebase コンソールに送信します。
これで、状況に応じて次の手順に進んでください。
使用可能な Pod
このセクションでは、iOS とその Pod でサポートされている Firebase プロダクトを一覧表示しています。Firebase iOS ライブラリの詳細については、以下をご覧ください。
Firebase iOS SDK GitHub リポジトリ
サービスまたはプロダクト | Pod | アナリティクスの追加 |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
|
アナリティクス | pod 'Firebase/Analytics' |
|
App Distribution | pod 'Firebase/AppDistribution' |
|
Authentication | pod 'Firebase/Auth' |
|
Cloud Firestore | pod 'Firebase/Firestore' |
|
Cloud Functions for Firebase Client SDK | pod 'Firebase/Functions' |
|
Cloud Messaging | pod 'Firebase/Messaging' |
|
Cloud Storage | pod 'Firebase/Storage' |
|
Firebase Crashlytics | pod 'Firebase/Crashlytics' |
|
Dynamic Links | pod 'Firebase/DynamicLinks' |
|
アプリ内メッセージング | pod 'Firebase/InAppMessaging' |
(必須) |
Firebase ML Vision API | pod 'Firebase/MLVision' |
|
Firebase ML カスタムモデル API | pod 'Firebase/MLModelInterpreter' |
|
Performance Monitoring | pod 'Firebase/Performance' |
|
Realtime Database | pod 'Firebase/Database' |
|
Remote Config | pod 'Firebase/RemoteConfig' |
非推奨:
サービスまたはプロダクト | Pod | 詳細 |
---|---|---|
Firebase 向け ML Kit: 画像ラベル付けモデル | pod 'Firebase/MLVisionLabelModel' |
移行ガイド |
Firebase 向け ML Kit: バーコード スキャンモデル | pod 'Firebase/MLVisionBarcodeModel' |
移行ガイド |
Firebase 向け ML Kit: テキスト認識モデル | pod 'Firebase/MLVisionTextModel' |
移行ガイド |
Firebase 向け ML Kit: 顔検出モデル | pod 'Firebase/MLVisionFaceModel' |
移行ガイド |
Firebase 向け ML Kit: オブジェクトの検出とトラッキング モデル | pod 'Firebase/MLVisionObjectDetection' |
移行ガイド |
Firebase 向け ML Kit: Natural Language API | pod 'Firebase/MLNaturalLanguage' |
移行ガイド |
Firebase 向け ML Kit: 言語識別モデル | pod 'Firebase/MLNLLanguageID' |
移行ガイド |
Firebase 向け ML Kit: 翻訳モデル | pod 'Firebase/MLNLTranslate' |
移行ガイド |
Firebase 向け ML Kit: スマート リプライモデル | pod 'Firebase/MLNLSmartReply' |
移行ガイド |
Firebase 向け ML Kit: AutoML Vision Edge API | pod 'Firebase/MLVisionAutoML' |
移行ガイド |
CocoaPods を使用せずに統合する
CocoaPods を使用しない場合でも、フレームワークを直接インポートするか、Swift パッケージ マネージャーを使用することで Firebase SDK を利用できます。
フレームワーク
iOS プラットフォームのサポートに加えて、zip にはコミュニティ ベースの Catalyst サポートを追加する .xcframework ファイルが含まれるようになりました。詳しくは、GitHub の Firebase iOS SDK の README をご覧ください。
framework SDK zip をダウンロードします。このファイルのサイズは約 200 MB で、ダウンロードに時間がかかる場合があります。
ファイルを解凍し、アプリに含めるフレームワークの
README
を確認します。ターゲットのビルド設定で
Other Linker Settings
にObjC
リンカーフラグを追加します。
Swift パッケージ マネージャー
Swift Package Manager のサポートは、現在ベータ版です。GitHub のドキュメントに従い、フィードバックを GitHub 公開バグトラッカーに提出してください。
次のステップ
以下で Firebase の詳細を確認します。
Firebase プロジェクトとプロジェクトに関するベスト プラクティスについては、Firebase プロジェクトについて理解するをご覧ください。
Firebase アプリのサンプルを確認する。
Firebase iOS Codelab を使用して実際に体験する。
GitHub のオープンソース コードを調べる。
アプリを起動する準備をする。
- GCP Console でプロジェクトの予算アラートを設定する。
- Firebase コンソールで使用量と請求ダッシュボードをモニタリングする。
- Firebase リリース チェックリストを確認する。
Firebase サービスをアプリに追加します。
アナリティクスでユーザー行動を把握する。
Authentication を使用してユーザー認証をセットアップする。
Cloud Firestore または Realtime Database にユーザー情報などのデータを保存する。
Cloud Storage に写真や動画などのファイルを保存する。
Cloud Functions を使用した安全な環境でバックエンド コードをトリガーする。
Cloud Messaging を使用して通知を送信する。
Crashlytics を使用してアプリがクラッシュする場所と理由を確認する。