前提条件
以下をインストールします。
- Xcode 13.3.1 以降
プロジェクトが次の要件を満たしていることを確認してください。
- プロジェクトは、これらのプラットフォーム バージョン以降をターゲットにする必要があります。
- iOS11
- macOS 10.13
- TVOS 12
- ウォッチOS 6
- プロジェクトは、これらのプラットフォーム バージョン以降をターゲットにする必要があります。
物理的な Apple デバイスをセットアップするか、シミュレーターを使用してアプリを実行します。
Apple プラットフォームでのクラウド メッセージングの前提条件は次のとおりです。
- 物理的な Apple デバイスをセットアップします。
- Apple Developer アカウントの Apple プッシュ通知認証キーを取得します。
- Xcode のApp > Capabilitiesでプッシュ通知を有効にします。
- Google アカウントを使用して Firebase にサインインします。
Xcode プロジェクトをまだお持ちでなく、Firebase 製品を試してみたいだけの場合は、クイックスタート サンプルのいずれかをダウンロードできます。
ステップ 1 : Firebase プロジェクトを作成する
Firebase を Apple アプリに追加する前に、Firebase プロジェクトを作成してアプリに接続する必要があります。 Firebase プロジェクトについて詳しくは、 Firebase プロジェクトを理解するをご覧ください。
ステップ 2 : アプリを Firebase に登録する
Apple アプリで Firebase を使用するには、アプリを Firebase プロジェクトに登録する必要があります。アプリを登録することは、多くの場合、アプリをプロジェクトに「追加する」と呼ばれます。
Firebase コンソールに移動します。
プロジェクト概要ページの中央にあるiOS+アイコンをクリックして、セットアップ ワークフローを起動します。
Firebase プロジェクトに既にアプリを追加している場合は、[アプリを追加] をクリックしてプラットフォーム オプションを表示します。
バンドル IDフィールドにアプリのバンドル ID を入力します。
バンドル IDは、Apple のエコシステム内のアプリケーションを一意に識別します。
バンドル ID を見つけます。Xcode でプロジェクトを開き、プロジェクト ナビゲーターでトップレベルのアプリを選択してから、[全般] タブを選択します。
Bundle Identifierフィールドの値はバンドル ID です (例:
com.yourcompany.yourproject
)。バンドル ID の値は大文字と小文字が区別されることに注意してください。この Firebase アプリを Firebase プロジェクトに登録した後は、この値を変更することはできません。
(オプション)その他のアプリ情報を入力します:アプリのニックネームとApp Store ID 。
アプリのニックネーム: Firebase コンソールでのみ表示される、内部の便利な識別子
App Store ID :ユーザーを App Store ページにリダイレクトするために Firebase Dynamic Links によって使用され、コンバージョン イベントを Google 広告にインポートするために Google アナリティクスによって使用されます。アプリに App Store ID がまだない場合は、後でプロジェクト設定で ID を追加できます。
[アプリを登録]をクリックします。
ステップ 3 : Firebase 構成ファイルを追加する
[GoogleService-Info.plist をダウンロード]をクリックして、Firebase Apple プラットフォーム構成ファイル (
GoogleService-Info.plist
) を取得します。Firebase 構成ファイルには、プロジェクトの一意であるが秘密ではない識別子が含まれています。この構成ファイルの詳細については、 Firebase プロジェクトを理解するをご覧ください。
Firebase 構成ファイルはいつでも再ダウンロードできます。
構成ファイル名に
(2)
のような追加の文字が追加されていないことを確認してください。
構成ファイルを Xcode プロジェクトのルートに移動します。プロンプトが表示されたら、構成ファイルをすべてのターゲットに追加することを選択します。
プロジェクトに複数のバンドル ID がある場合、各アプリが独自のGoogleService-Info.plist
ファイルを持つことができるように、各バンドル ID を Firebase コンソールの登録済みアプリに関連付ける必要があります。
ステップ 4 : アプリに Firebase SDK を追加する
Swift Package Manager を使用して、Firebase の依存関係をインストールおよび管理します。
- Xcode で、アプリ プロジェクトを開いた状態で、 File > Add Packagesに移動します。
- プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
- 使用する SDK バージョンを選択します。
使用する Firebase ライブラリを選択します。
Firebase プロジェクトで Google アナリティクスが有効になっている場合は、必ず
FirebaseAnalytics
を追加してください。 IDFA 収集機能のないアナリティクスの場合は、代わりにFirebaseAnalyticsWithoutAdId
を追加してください。
https://github.com/firebase/firebase-ios-sdk
完了すると、Xcode はバックグラウンドで依存関係の解決とダウンロードを自動的に開始します。
ステップ 5 : アプリで Firebase を初期化する
最後のステップは、アプリケーションに初期化コードを追加することです。 Firebase をアプリに追加する際に、すでにこれを行っている場合があります。クイックスタート サンプル プロジェクトを使用している場合、これは既に行われています。
-
UIApplicationDelegate
にFirebaseCore
モジュールをインポートし、アプリ デリゲートが使用する他のすべてのFirebase モジュールをインポートします。たとえば、Cloud Firestore と認証を使用するには:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
迅速
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- アプリ デリゲートの
application(_:didFinishLaunchingWithOptions:)
メソッドでFirebaseApp
共有インスタンスを構成します。SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
迅速
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI を使用している場合は、アプリケーション デリゲートを作成し、それを
UIApplicationDelegateAdaptor
またはNSApplicationDelegateAdaptor
を介してApp
構造体にアタッチする必要があります。アプリ デリゲート スウィズリングも無効にする必要があります。詳細については、 SwiftUI の説明を参照してください。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Google アナリティクス用の Firebase SDK が含まれている場合は、アプリを実行して、Firebase が正常にインストールされたことを示す確認を Firebase コンソールに送信できます。
それでおしまい!次のステップに進むことができます。
ただし、セットアップに問題がある場合は、 Apple プラットフォームのトラブルシューティングと FAQにアクセスしてください。
利用可能なライブラリ
このセクションでは、Apple プラットフォームでサポートされている Firebase 製品を一覧表示します。これらの Firebase Apple プラットフォーム ライブラリの詳細をご覧ください。
Firebase Apple プラットフォーム SDK GitHub リポジトリ
サービスまたは製品 | ポッド | SwiftPM ライブラリ | アナリティクスを追加しますか? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | なし | |
分析 | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
アプリチェック | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
アプリの配布 | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
認証 | pod 'FirebaseAuth' | FirebaseAuth | |
クラウド ファイアストア | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions for Firebase クライアント SDK | pod 'FirebaseFunctions' | FirebaseFunctions | |
クラウド メッセージング | pod 'FirebaseMessaging' | FirebaseMessaging | |
クラウドストレージ | pod 'FirebaseStorage' | FirebaseStorage | |
クラッシュリティクス | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
動的リンク | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
アプリ内メッセージ | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (必要) |
Firebase のインストール | pod 'FirebaseInstallations' | FirebaseInstallations | |
Firebase ML カスタム モデル API | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
パフォーマンス監視 | pod 'FirebasePerformance' | FirebasePerformance | |
リアルタイム データベース | pod 'FirebaseDatabase' | FirebaseDatabase | |
リモート設定 | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Swift Package Manager を使用せずに統合する
Swift Package Manager を使用したくない場合でも、CocoaPods を使用するか、フレームワークを直接インポートすることで Firebase SDK を利用できます。
ココアポッド
CocoaPods の統合について詳しくは、ガイドをご覧ください。
フレームワーク
iOS プラットフォームのサポートに加えて、zip には.xcframework
ファイルが含まれるようになりました。詳細については、 GitHub の Firebase Apple プラットフォーム SDK README を参照してください。
フレームワーク SDK zipをダウンロードします。これは約 200 MB のファイルで、ダウンロードには時間がかかる場合があります。
ファイルを解凍し、アプリに含めるフレームワークの
README
を確認します。ターゲットのビルド設定の
Other Linker Settings
に-ObjC
リンカー フラグを追加します。
次のステップ
Firebase について学ぶ:
Firebase プロジェクトとプロジェクトのベスト プラクティスについて詳しくは、 Firebase プロジェクトを理解するをご覧ください。
サンプルの Firebase アプリを調べる。
Firebase iOS Codelabで実践的な体験をしてください。
アプリを起動する準備をします。
- Google Cloud Console でプロジェクトの予算アラートを設定します。
- Firebase コンソールで使用状況と請求のダッシュボードを監視して、複数の Firebase サービスにわたるプロジェクトの使用状況の全体像を把握します。
- Firebase の起動チェックリストを確認します。
Firebase と Apple プロジェクトに問題がありますか? Apple プラットフォームのトラブルシューティングと FAQにアクセスしてください。
アプリに Firebase サービスを追加します。
Analyticsを使用して、ユーザーの行動に関する洞察を得る。
Authenticationでユーザー認証を設定します。
Cloud FirestoreまたはRealtime Databaseを使用して、ユーザー情報などのデータを保存します。
写真や動画などのファイルをCloud Storageに保存します。
Cloud Functionsを使用して安全な環境で実行されるバックエンド コードをトリガーします。
Cloud Messagingで通知を送信します。
Crashlyticsを使用して、アプリがクラッシュする時期と理由を調べます。