はじめに
プッシュ通知の動作確認、地味に面倒じゃないですか? 通知を1回受け取るためだけにサーバー側から送ってもらったり、テスト用のスクリプトを用意したり……。
iOSシミュレータなら、サーバーなし・コマンド1発で通知の受信をテストできます。その方法をまとめておきます。
Xcode 11.4で追加された機能で(Xcode 11.4 Release Notes)、この記事の内容はXcode 27.2 / iOS 27.2のシミュレータで確認しています。
準備:アプリを入れて通知を許可する
テストしたいアプリをシミュレータで一度起動し、通知の許可ダイアログで「許可」を選んでおきます。
① 通知の中身をファイルに書く
送りたい通知の内容を、test.apns という名前のテキストファイルに書きます。
{
"aps": {
"alert": {
"title": "テスト通知",
"body": "simctlから送信された通知です"
},
"badge": 1,
"sound": "default"
}
}
それぞれの項目の意味は次のとおりです。
| 項目 | 意味 |
|---|---|
title |
通知のタイトル |
body |
通知の本文 |
badge |
アプリアイコンの右上に付く数字 |
sound |
通知音(default は標準の音) |
これは、本番のプッシュ通知でAppleの配信サービス(APNs)に渡すデータと同じ書き方です。サーバーからAPNsへ直接送っている場合は、そこで使っている内容をそのまま貼り付けて試せます。
② コマンドで送信する
Macの「ターミナル」アプリを開き、test.apns を置いたフォルダで以下を実行します。
xcrun simctl push booted com.example.myapp test.apns
コマンドの各部分はこういう意味です。
| 部分 | 意味 |
|---|---|
xcrun simctl push |
シミュレータに通知を送る、Xcode付属のコマンド |
booted |
いま起動しているシミュレータ |
com.example.myapp |
通知を送る先のアプリ |
test.apns |
①で作ったファイル |
com.example.myapp の部分は、テストしたいアプリのBundle Identifier(アプリごとに決まっているID)に置き換えてください。Xcodeのターゲット設定で確認できます。
実行すると、シミュレータに通知バナーが表示されます。
アプリのIDをファイルに書いておくともっと楽
ファイルに Simulator Target Bundle という項目を足してBundle Identifierを書いておくと、コマンドでの指定を省略できます。
{
"Simulator Target Bundle": "com.example.myapp",
"aps": {
"alert": {
"title": "テスト通知",
"body": "simctlから送信された通知です"
}
}
}
xcrun simctl push booted test.apns
注意点
うまく届かないときは、次の点を確認してみてください。
-
通知を許可しているか:許可していないアプリに送ると、
Source is not authorizedというエラーになります。 -
シミュレータを複数起動していないか:
bootedは起動中のどれか1台に送るので、別のシミュレータが選ばれることがあります。その場合はbootedの代わりに、シミュレータごとのID(UDID)を指定します。UDIDはxcrun simctl list devices bootedで確認できます。 - アプリを開いたままにしていないか:アプリを画面に表示している間は、アプリ側で「開いているときも表示する」実装をしていないとバナーが出ません。ホーム画面に戻ってから送るのが確実です。
なお、これはシミュレータの中だけで通知を再現する機能です。Appleのサーバーを経由する本物の配信経路は通らないので、そこを含めた最終確認は実機で行いましょう。画面に何も表示しない「サイレント通知」も、試した範囲ではアプリ側の受信処理(didReceiveRemoteNotification)が呼ばれませんでした。
まとめ
| やりたいこと | 方法 |
|---|---|
| 通知を送る | xcrun simctl push booted <Bundle Identifier> test.apns |
| アプリのIDの指定を省略する | ファイルに "Simulator Target Bundle" を追加 |
通知の見た目を確認するだけなら、xcrun simctl push だけ覚えておけば十分です。

