
シミュレーターでは確かめられないこと:Claude と iOS アプリを作るときの実機の出番
Claude Code(AI)と一緒に iOS アプリを作っていて、動きの確認をシミュレーター(Mac の中で動く iPhone)に任せている人に向けて書きました。
私は、個人で作る iPhone のゲームや道具のアプリを、Claude と作っています。作っている途中の確認は、ほとんど Claude がシミュレーターでやってくれます。それでも、実際の iPhone(実機)に入れて初めて見つかった不具合がありました。
この記事で分かることは、次の3つです。
シミュレーターでは見つからず、実機で見つかった不具合の実例
シミュレーターでは、そもそも確かめられないこと
実機を見る出番を、作る手順のどこに入れたか
Claude が確かめる所、私が確かめる所
Claude は、シミュレーターでアプリをビルドして起動し、画面をタップして、スクリーンショットを撮って確かめることができます。
確認を速くするために、アプリには最初から、確認用の起動のしかたを用意しています。
決まった画面にすぐ移る
自動で遊ぶ
広告を出さない
時刻を決めて起動する
ゲームなら、すべての面を自動で遊んで、クリアできるかを確かめるテストも書いてもらっています。
こうした確認は、Claude に任せられます。一方で、実機に入れて私が触ってみると、シミュレーターでは問題がなかった所で不具合が見つかることがありました。私が実機で見るのは、TestFlight(公開前のアプリを自分の iPhone に入れて試せる、Apple の仕組み)に上げたビルドです。
実機で見つかったこと
ドラッグしている間、画面に何も出なかった
キャラクターを、画面の端に並べたカードからドラッグして、盤面のマスに置くゲームを作っていたときのことです(2026年10月21日)。
TestFlight で実機に入れて試すと、カードから引き出している間だけ、指の先のキャラも、置き先のマスの光も出ませんでした。指を離すと、キャラはちゃんと置かれます。ドラッグしている間の、画面の描き直しだけが止まっていました。
同じ画面でも、盤面の上でキャラを動かすドラッグは、ちゃんと見えていました。違いは、ドラッグをどこで受けていたかです。
見えなかった:SwiftUI の DragGesture で受けていたドラッグ
見えていた:SpriteKit(ゲームの画面)の touches で受けていたドラッグ
カードからのドラッグを、UIKit のビューの touches で受けるように変えると、次のビルドで実機でもドラッグ中の表示が出ました。
これがシミュレーターで見つからなかったのには、理由があります。Claude がシミュレーターに送る指の動きは、一瞬でまとめて届きます。指を離した後の結果は確かめられても、ドラッグしている途中の見た目は、確かめようがありませんでした。
広告の音と、ゲームの BGM が重なった
全画面の広告(動画を見るとごほうびがもらえる広告など)を出すと、広告の音とゲームの BGM が重なって鳴っていました。2026年10月19日〜20日に、2つのゲームの TestFlight で気づきました。
シミュレーターでは、本物の広告の代わりに、自前の「擬似広告」の画面を出して確かめていました。擬似広告では、音が重なることに気づけませんでした。
今は、全画面の広告を出す直前に BGM と効果音を止め、広告を閉じたら BGM を続きから再開するようにしています。
広告が「読み込み中」のまま止まった
さかのぼって、2026年9月18日のことです。TestFlight で、広告を見てごほうびをもらうボタンが、「読み込み中」のまま止まりました。広告の配信が、まだ始まっていなかったためです。
広告がまだ出ない間でも遊べるように、広告の読み込みに2回失敗したら、代わりの画面を出すようにしました。この代わりの画面が、先に書いた「擬似広告」です。
なお、地図の表示がちらつく不具合も、実機に入れて初めて見つかりました。そのときのことは、2本目のアプリの記事に書いています。
シミュレーターでは、そもそも確かめられないこと
実機でしか見つからない不具合とは別に、シミュレーターでは、はじめから確かめられないこともありました。
Game Center:シミュレーターではサインインできない。Game Center の確認は TestFlight で行う
アプリ内の課金:Xcode には、課金を試すための設定ファイルがある。ただ、これが効くのは Xcode の画面から起動したときだけで、Claude がコマンドで起動したアプリでは商品が読み込めなかった(2026年10月25日)。課金の確認は、TestFlight のテスト用の環境で行う
絵文字:私の Mac のシミュレーターでは、絵文字のフォントが読めず、「?」の四角で表示された(2026年10月22日)。ストアに載せるスクショもシミュレーターで撮るので、画面の絵に絵文字は使わないことにした
逆に、シミュレーターでだけ出るエラーもあります。たとえば、署名をせずにシミュレーター用にビルドすると、Firebase(アプリの利用状況を集める道具など)が、キーチェーンを使えないというエラーを出します。実機では出ません。
シミュレーターで出たエラーが、アプリの不具合なのか、シミュレーターだからなのかを、見分ける必要があります。見分けた結果は、開発の環境についてのルールのファイルに書き残しています。
実機の出番を、手順に入れた
実機を見るタイミングを決めた
実機は、気が向いたときに見るのではなく、見るタイミングを手順に書きました。
作り込みが終わったとき
TestFlight にビルドを上げたとき
ルールのファイルには、次のように書いています(要点だけ抜き出しています)。
- 実機でしか気づけない不具合(再生時のちらつき、表示の崩れ)があるので、
作り込みの終わりと TestFlight で必ず実機を見る
- 一瞬のちらつきはスクショでは捉えられない。録画して確かめる
ちらつきのように一瞬で消えるものは、Claude がスクショを撮っても写りません。シミュレーターでも、画面を録画すれば確かめられます。
アプリごとに「実機で見ること」を書き出す
アプリごとのメモには、確認事項の中に「実機で見ること」を書き出すようにしました。たとえば、最近作ったゲームでは、次のように書いています。
動く速さ(マスがいちばん細かい面で)
タップのしやすさ
マスがたくさんある面で、描画が重くないか
本物の広告が出るか、広告の音と BGM が重ならないか
課金が通るか
音については、もう1つ分けて考えています。効果音や BGM は Claude が作ってくれますが、Claude が確かめられるのは、数値だけです。実際にどう聞こえるかは、私がシミュレーターと実機で聞いて確かめます。
こうして書き出しておくと、TestFlight のビルドを触るときに、何を見ればよいかで迷いません。Claude に確かめてもらうことと、私が実機で確かめることの境目も、はっきりします。
おわりに
まとめると、次の3つです。
ドラッグしている途中の見た目や、広告の音のように、シミュレーターでは確かめられず、実機で初めて分かる不具合があった
Game Center や課金のように、シミュレーターでははじめから確かめられないものもある。逆に、シミュレーターでだけ出るエラーもある
実機を見るタイミング(作り込みの終わりと TestFlight)と、アプリごとの「実機で見ること」を、手順に書いておく
Claude にシミュレーターでの確認を任せられるようになると、つい、それで確認が済んだ気になります。だからこそ、実機で触る出番を、先に手順に入れておくのがおすすめです。
Claude に作業を分けて任せるときに、先に用意しておくものについては、こちらの記事に書きました。