iOS用SDKを導入したい

動作環境について

iOSのb→dash mobile SDKにおいて、推奨環境と動作環境について紹介します。
下記に、b→dash mobile SDK（v5.0.2）の推奨環境と動作環境についてまとめましたのでご参照ください。

#import "【プロジェクト名】-Swift.h"

Firebase Cloud Messaging(FCM)はGoogleが提供しているモバイル・Webアプリケーション開発プラットフォームです。b→dashではFCM利用してSDKを実装します。
CocoaPodsはiOS/Mac向けアプリ開発のライブラリ管理システムです。b→dashのSDK実装に利用するライブラリを管理するため必要となります。

Firebase Cloud Messaging(FCM), CocoaPodsの詳細については以下の公式ドキュメントをご参照ください。
– Firebase Cloud Messaging  |  Firebase Documentation
– CocoaPods.org

CocoaPodsとFirebase Cloud Messaging(FCM)のインストール

以下バージョンの「Firebase Cloud Messaging(FCM)」「CocoaPods」をインストールします。

– FCMバージョン : 7.10.0
– CocoaPodsバージョン : 1.11.3

## Podfile への導入例
pod 'Firebase/Core','7.10.0'
pod 'Firebase/Messaging','7.10.0'

Push通知を行う場合の追加設定

以下では、b→dash mobile SDKを用いてPush通知を行いたい場合の追加設定を説明します。

➊『HTTP v1 API』を利用する場合

Push通知の配信に『HTTP v1 API』を利用する場合は、はじめに「Firebase Console」にて「秘密鍵」を生成する必要があります。

「秘密鍵」の生成方法については、「Push通知の送信元を設定したい」の『秘密鍵の生成方法』をご参照ください。

[参考：Firebase Console]

➋ Firebaseプロジェクトの準備

FCM を利用する際は、b→dashSDK を導入する予定のアプリを Firebase プロジェクトへと追加する必要があります。

b→dashSDK を導入する予定のアプリを Firebase プロジェクトへと追加します

以下の公式ドキュメントを参照して貴社で Firebase プロジェクトを作成し、b→dashSDKを導入する予定のアプリを追加します。
Firebase を Apple プロジェクトに追加する  |  Firebase Documentation
– ステップ 1:Firebase プロジェクトを作成する

[GoogleService-Info.plistをダウンロードします

以下の公式ドキュメントを参照して、Firebase プロジェクトからFirebase 構成ファイルである 「[GoogleService-Info.plist」をダウンロードします。
Firebase を Apple プロジェクトに追加する  |  Firebase Documentation

Firebaseプロジェクトへ「[GoogleService-Info.plist」を追加します

Xcodeのプロジェクトのナビゲータエリア内の任意の場所を右クリックし、「Add Files to “ターゲット名”」 を選択します。

その後、GoogleServiece-Info.plistを選択し「Add」をクリックします。

❸ XcodeプロジェクトのPush通知を有効にする

b→dash mobile SDKでPush通知を実装するにあたり、XcodeプロジェクトファイルのPush通知を有効化する必要があります。

プロジェクト設定を開き + Capability から、Push Notification の追加を行います

Push Notification が追加されたことを確認できます

➍ プロパティリストへの設定値の追加

「Firebaseプロジェクトの準備」にてFirebaseプロジェクトへ導入した「GoogleServiece-Info.plist」に、Push通知を実装するのに必要な設定値を再度追加する必要があります。

プロジェクト内の「Info.plist」にFirebaseAppDelegateProxyEnabled（Boolean） のプロパティを追加し、バリューに「0」を設定します

リッチPush通知を行う場合の追加設定

リッチPush通知を行う場合は「通知設定を行う場合の追加設定」に加えて以下の追加設定を行う必要があります。

App Group の設定

「リッチプッシュ通知」の配信をご希望の場合、AppleDeveloper にてプッシュ通知および App Group が有効である証明書を用意し、App Group のIdentifiers をアプリ本体の証明書および Extension の証明書と紐づける必要があります。

Apple DeveloperにログインしてIdentifiersからApp Groupを生成します

Idntifirersにはの APP_BDASH_APP_GROUP_IDを設定します。

生成した App Group の Identifiers をアプリ本体の証明書および Extension の証明書と紐づけします

アプリ証明書の設定(Certificates, Indentifiers & Profiles)を開き、「App Groups」にチェックをいれ、「Edit」をクリックします。

App Groupの割り当て設定を変更します

tracking.plistのAPP_BDASH_APP_GROUP_IDにチェックを入れて、「Continue」をクリックします。確認画面が表示されるので、「Assign」をクリックします。

XcodeのProjectのTargetに「NotificationServiceExtension」を追加します

※既にNotificationServiceExtensionを利用している場合は不要です

App Groupsを有効に設定し、App Group IDを選択します

アプリ本体とNotificationServiceExtensionには同じApp Group IDを指定してください。

NotificationService.swiftへのコード追加

自動で生成されたNotificationService.swift に zip 付属の「BDashNotificationService.swift」から必要に応じてソースコードのコピーを行います。

Notification Service Extensionを未実装の場合は中身をそのままコピーしてください。