- ニフクラ mobile backendの『プッシュ通知』機能を利用したサンプルプロジェクトです!
- 全配信だけでなく、ユーザー(端末)のグループで絞り込んでプッシュ通知を送れます。たとえば、appleとorangeとbananaという重複可能なグループがあったときに、appleに属しているユーザー(端末)にだけプッシュ通知を送ることが出来ます。
- 簡単な操作ですぐに ニフクラ mobile backendの機能を体験いただけます!!
スマートフォンアプリのバックエンド機能(プッシュ通知・データストア・会員管理・ファイルストア・SNS連携・位置情報検索・スクリプト)が開発不要、しかも基本無料(注1)で使えるクラウドサービス!
注1:詳しくはこちらをご覧ください
- Mac OS 12.5.1 (Monterey)
- Xcode Version 14.0
- iPhone X (iOS 16)
- このサンプルアプリは、実機ビルドが必要です
※上記内容で動作確認をしています
- ニフクラ mobile backendのプッシュ通知は、iOSが提供している通知サービスを利用しています
- iOSの通知サービス APNs(Apple Push Notification Service)
- 上図のように、アプリ(Xcode)・サーバー(ニフクラ mobile backend)・通知サービス(APNs)の間でやり取りを行うため、認証が必要になります
- 認証に必要な鍵や証明書の作成は作業手順の「0.プッシュ通知機能使うための準備」で行います
- これから、次のような流れで作業を行います(少し長いので休憩しつつ行うことをオススメします)
- プッシュ通知機能を使うための準備
- ニフクラ mobile backendの会員登録とログイン→アプリ作成と設定
- GitHubからサンプルプロジェクトのダウンロード
- Xcodeでアプリを起動
- 実機ビルド
- 動作確認
- プッシュ通知を送りましょう!
【iOS】プッシュ通知の受信に必要な証明書の作り方(開発用)
- 上記のドキュメントをご覧の上、必要な証明書類の作成をお願いします
- 証明書の作成にはApple Developer Programの登録(有料)が必要です
- 上記リンクから会員登録(無料)をします。登録ができたらログインをすると下図のように「アプリの新規作成」画面が出るのでアプリを作成します
- アプリ作成されると下図のような画面になります
- この2種類のAPIキー(アプリケーションキーとクライアントキー)はXcodeで作成するiOSアプリにニフクラ mobile backendを紐付けるために使用します
- 続けてプッシュ通知の設定を行います
- ここで⑦APNs用証明書(.p12)の設定も行います
3. GitHubからサンプルプロジェクトのダウンロード
-
下記リンクをクリックしてプロジェクトをダウンロードをMacにダウンロードします
- ダウンロードしたフォルダを開き、「SwiftSegmentPushdApp.xcworkspace」をダブルクリックしてXcode開きます(白い方です)
- 「SwiftSegmentpushApp.xcodeproj」(青い方)ではないので注意してください!
- 始めて実機ビルドをする場合は、Xcodeにアカウント(AppleID)の登録をします
- メニューバーの「Xcode」>「Preferences...」を選択します
- Accounts画面が開いたら、左下の「+」をクリックします
- Apple IDとPasswordを入力して、「Add」をクリックします
- 追加されると、下図のようになります。追加した情報があっていればOKです
- 確認できたら閉じます。
- プロジェクトをクリックして、「Build Settings」>「Code Signing」に②開発用証明書(.cer)と⑤プロビジョニングプロファイルを設定します
- 「Code Signing Identity」に②開発用証明書(.cer)を設定しますが、「Provisioning Profile」に作成した⑤プロビジョニングプロファイルを設定すれば、「Code Signing Identity」の部分は「Automatic」で構いません
- 注意:作成した⑤プロビジョニングプロファイルは一度ダブルクリックをしておかないと、「Provisioning Profile」に設定できません
- Bundle ID を設定します
- 「General」>「Identity」の「Bundle Identifier」に③AppID を作成したときに入力したBundle IDに書き換えてください
- 設定は完了です
- lightningケーブルで④端末の登録で登録した、動作確認用iPhoneをMacにつなぎます
- Xcode画面で左上で、接続したiPhoneを選び、実行ボタン(さんかくの再生マーク)をクリックします
- ビルド時にエラーが発生した場合の対処方法
- Xcodeのバージョンが古い場合
import NCMB
にエラーが発生し、上手くSDKが読み込めないことがあります
- インストールしたアプリを起動します
- 注意!!! プッシュ通知の許可を求めるアラートが出たら、必ず許可してください!
- 起動されたらこの時点でデバイストークンが取得されます
- ニフクラ mobile backendのダッシュボードで「データストア」>「installation」クラスを確認してみましょう!
- ニフクラ mobile backendのダッシュボードで「プッシュ通知」>「+新しいプッシュ通知」をクリックします
- プッシュ通知のフォームが開かれます
- 必要な項目を入力して「プッシュ通知を作成する」をクリックします
- 端末を確認しましょう!
- 少し待つとプッシュ通知が届きます!!!
今回は、ユーザーの属性を「apple」、「orange」、「banana」の3つのグループに分けます(グループは重複していても良いとします)。「apple」か「orange」、どちらかのグループに入っているユーザーに対してプッシュ通知を送ってみましょう。
- アプリをまず起動しましょう。初期状態はこのような状態になっており、channelsの編集と新しいフィールドの追加ができます
- "channels"は、mBaaSに最初から用意されているフィールドで、任意の配列を入れることができます。今回はグループ分けに使っていますが、使い方は自由です
-
channelsに、"apple,orange"と入れてみましょう
-
channelsは
,
で区切ることで、配列の要素として処理することができます -
同時に新しいフィールドの追加もしてみましょう。"favorite"というフィールドを作り、中身には"music"と入れてみました。こうすることで、ユーザーに新しい属性を付与することができるようになります!
-
編集が完了したら送信ボタンをタップして下さい
- 送信後、viewが自動でリロードされ、追加・更新が行われていることがわかります。追加したフィールドは後から編集することが可能です
- ダッシュボードから、更新ができていることを確認してみましょう!
- 端末側で起動したアプリは一度閉じておきます
- プッシュ通知を作成する際に、「配信端末」を「installationクラスから絞り込み」に設定します
- channelsに「apple」と「orange」が含まれている人だけにプッシュ通知を送る場合は、次のように設定します
- 作成をクリックし、少し待つと端末にプッシュ通知が届きます。・・・届きましたか??
- 作成したプッシュ通知の「SearchCondition」を開くとどのように絞りこまれているか確認することができます
- ちなみに、「banana」で絞り込もうとした場合はが配信端末がなしになります。試して確認してみましょう!
- 上のようにinstallationの絞り込み設定をしてプッシュ通知を作成することで、特定のグループや個人に対してプッシュ通知を送ることができます!!
- 「favorite」が「music」のユーザーにだけ配信や、ある特定のユーザーにだけ配信ということも出来ます。
- 様々な絞り込みを試してみましょう!
サンプルプロジェクトに実装済みの内容のご紹介
- ニフクラ mobile backend のドキュメント(クイックスタート)をご用意していますので、ご活用ください
AppDelegate.swift
のdidFinishLaunchingWithOptions
メソッドにAPNsに対してデバイストークンの要求するコードを記述し、デバイストークンが取得された後に呼び出されるdidRegisterForRemoteNotificationsWithDeviceToken
メソッドを追記をします- デバイストークンの要求はiOSのバージョンによってコードが異なります
import UIKit
import NCMB
import UserNotifications
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
var window: UIWindow?
// APIキーの設定
let applicationkey = "YOUR-APPLICATION-KEY"
let clientkey = "YOUR-CLIENT-KEY"
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
// SDKの初期化
NCMB.initialize(applicationKey: applicationkey, clientKey: clientkey)
// Register notification
registerForPushNotifications()
return true
}
// デバイストークンが取得されたら呼び出されるメソッド
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
let tokenParts = deviceToken.map { data in String(format: "%02.2hhx", data) }
let token = tokenParts.joined()
print("Device Token: \(token)")
let installation = NCMBInstallation()
installation.setDeviceTokenFromData(data: deviceToken)
installation.saveInBackground { (error) in
}
}
}
ViewController.swift
のgetInstallation
メソッド内でinstallationクラスを生成しています.allkey()
で、フィールドを全件取得できます.objectForKey()
で、指定したフィールドの中身を取り出すことができます
func getInstallation() {
//installationの生成
let installation = NCMBInstallation.currentInstallation
//ローカルのinstallationをfetchして更新
installation.fetchInBackground(callback: { result in
switch result {
case .success:
print("取得成功:\(installation)")
DispatchQueue.main.async {
self.updateTable()
}
case let .failure(error):
print(error)
}
})
}
postInstallation
メソッド内で行います。.setObject()
で更新内容とフィールド名を指定し、.saveInBackgroundWithBlock
で更新します
installation.saveInBackground(callback: { result in
switch result {
case .success:
//insitallation更新成功時の処理
print("installation更新に成功しました")
case let .failure(error):
//installation更新失敗時の処理
print("installation更新に失敗しました :\(error)")
//アラートを出す
DispatchQueue.main.async {
let errAlert: UIAlertController = UIAlertController(title: "ERROR!", message: "installation更新に失敗しました", preferredStyle: .alert)
let okAction = UIAlertAction(title: "OK", style: .default) { action in
}
errAlert.addAction(okAction)
self.present(errAlert, animated: true, completion: nil)
}
}
})
- 更新後は自動でviewのリロードが実行され、更新内容が書き換わります
- 同じ内容の【Objective-C】版も作成しておりますのでお待ちください