0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

iOSシミュレータでプッシュ通知をテストする方法(サーバー不要・xcrun simctl)

0
Last updated at Posted at 2026-11-13

はじめに

プッシュ通知の動作確認、地味に面倒じゃないですか? 通知を1回受け取るためだけにサーバー側から送ってもらったり、テスト用のスクリプトを用意したり……。

iOSシミュレータなら、サーバーなし・コマンド1発で通知の受信をテストできます。その方法をまとめておきます。

Xcode 11.4で追加された機能で(Xcode 11.4 Release Notes)、この記事の内容はXcode 27.2 / iOS 27.2のシミュレータで確認しています。

準備:アプリを入れて通知を許可する

テストしたいアプリをシミュレータで一度起動し、通知の許可ダイアログで「許可」を選んでおきます。

通知の許可ダイアログ

① 通知の中身をファイルに書く

送りたい通知の内容を、test.apns という名前のテキストファイルに書きます。

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のターゲット設定で確認できます。

実行すると、シミュレータに通知バナーが表示されます。

simctl pushで通知バナーが表示された様子
(images/01_banner.png)

アプリのIDをファイルに書いておくともっと楽

ファイルに Simulator Target Bundle という項目を足してBundle Identifierを書いておくと、コマンドでの指定を省略できます。

test.apns
{
  "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 だけ覚えておけば十分です。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?