メインコンテンツへスキップ
見出し画像

シミュレーターでは確かめられないこと: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 に作業を分けて任せるときに、先に用意しておくものについては、こちらの記事に書きました。


     
     
    Claude Codeに「仕事の段取り」を覚えさせ、iPhoneアプリとKindle本を作っています。失敗も含め、手順と数字つきで正直に書きます。 著書『Claudeと作る、はじめてのKindle本』 https://www.amazon.co.jp/dp/B0HNGTD5FH

    あなたへのおすすめ