始める前に
事前に次の環境を準備しておく必要があります。
- Firebase が有効なアプリ: まだ iOS プロジェクトに Firebase を追加していない場合は追加します。
- Xcode 11.0 以降: Firebase アプリ内メッセージングを実行するには、比較的新しいバージョンの Xcode が必要です。最新バージョンの Xcode は Apple の Xcode サイトにあります。
- CocoaPods 1.4.0 以降: Firebase アプリ内メッセージングでは、CocoaPods を使用して iOS 上での依存関係を管理します。CocoaPods は CocoaPods サイトからインストールできます。
プロジェクトに Firebase アプリ内メッセージング SDK を追加する
始めに、Firebase アプリ内メッセージング CocoaPods を追加して、Firebase アプリ内メッセージング SDK フレームワーク ファイルをプロジェクトに追加します。
- 新しいターミナル ウィンドウを開き、Xcode プロジェクトのディレクトリに移動します。
- Podfile を開き、強調表示されている行を追加します。
# Uncomment the next line to define a global platform for your project # platform :ios, '9.0' target 'YourProject' do # Comment the next line if you're not using Swift and don't want to use dynamic frameworks use_frameworks! # Pods for YourProject pod 'Firebase' pod 'Firebase/InAppMessaging' pod 'Firebase/Analytics' end
- ターミナルで、ポッドの依存関係をインストールします。
pod install
- Xcode でアプリのプロジェクトを開きます。
open YOUR-PROJECT.xcworkspace
- 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];
- アプリをコンパイルして実行します。
テスト メッセージを送信する
アプリのインストール ID を取得する
電力を節約するため、Firebase アプリ内メッセージングはサーバーからのメッセージの取得を 1 日に 1 回だけ行います。この設定の場合、テストが困難になることがあるため、メッセージをオンデマンドで表示するテストデバイスを Firebase コンソールで指定できます。
このテストデバイスは、Firebase インストール サービスによって提供される Firebase のインストール ID によって決まります。テスト用アプリのインストール ID を確認するには、ランタイム コマンドの引数 -FIRDebugEnabled
を指定してアプリを実行します。
- Xcode プロジェクトを開き、上部のメニューバーから [Product] > [Scheme] > [Edit scheme] の順に選択します。
- ポップアップ表示されたダイアログの [Arguments] タブを開きます。
- [Arguments Passed On Launch] で [+ Add items] をクリックします。
- 新しく作成されたフィールドに「-FIRDebugEnabled」と入力します。
- [Close] をクリックし、アプリを実行します。
アプリの実行が開始されたら、Xcode コンソールのログで次の行を探します。
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID
テストデバイスにメッセージを送る
テストデバイスでアプリを起動し、Firebase インストール ID(FID)を取得したら、テスト メッセージを送信して Firebase アプリ内メッセージングの設定を試すことができます。
- Firebase コンソールで [アプリ内メッセージング] を開きます。
- [新しいキャンペーンを作成] をクリックします。
- 最初のメッセージのタイトルを入力します。
- [デバイスでテスト] をクリックします。
- [インストール ID の追加] フィールドにアプリの Firebase インストール ID を入力します。
- [テスト] をクリックしてメッセージを送信します。
[テスト] をクリックするとすぐに Firebase アプリ内メッセージングからテスト メッセージが送信されます。このメッセージを表示するには、テストデバイスでアプリを閉じてから開き直します。
デバイスがテストデバイスかどうかを確認するには、次のログメッセージを探します。
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.