AIが申請する時代のiPhoneアプリ開発
スマホ向けのドット絵のレースゲーム「GT ROAD」を App Store に出しました。コードを書くだけでなく、ビルド、TestFlight へのアップロード、App Store Connect の入力、審査への提出、却下されたときの対応まで、ほとんどを Claude Code に任せています。
アプリの申請は、開発の中でも手作業が多く残されてきた領域です。証明書や署名の管理、管理画面での多岐にわたる項目入力、英語での審査対応など、手順が複雑で自動化しにくい要素が重なっています。コード生成を行う AI ツールは一般的になりましたが、ストアへの提出手続きは開発者が深夜に手作業で進めるもの、という前提がこれまでは一般的でした。
実際に任せてみると、ビルドスクリプトの作成やブラウザ経由のメタデータ入力、リジェクト時の原因調査まで自律的に進みました。その一方で、Apple ID による本人確認や法的な宣誓など、人間が対応を引き受けなければならない境界線も明確になりました。
作ったもの
GT ROAD は、メカニックとしてレースチームに入り、エンジニア、監督へと昇格していくシミュレーションゲームです。ピット作業のミニゲームでタイムを縮め、戦略を組み立ててレースを戦い、監督の立場ではスポンサー獲得や資金繰りの管理を担当します。
Web 版として試作したロジックを Godot に移植し、iOS と Android 向けに書き出しています(移植の経緯は前の記事に書きました)。グラフィックと音声はすべてコードで動的に生成しており、画像や音声の静的素材ファイルは保持していません。
iOS 対応の着手から初版のストア公開までは 2 日ほどでした。iOS 向けの書き出しに成功したのが初日の夜 11 時半で、翌日の午後には、本番ビルドの書き出し、スクリーンショット撮影、TestFlight へのアップロードが 1 コマンドで完了する体制が整いました。以降の機能追加でも、同様の手順で TestFlight への配信と審査提出を継続しています。
ビルドとアップロードのスクリプト化
Godot は iOS 向けに Xcode プロジェクトを出力します。そこから先の処理は Xcode のツール群が担うため、Claude Code はプロジェクト出力から App Store Connect へのアップロードまでをシェルスクリプトにまとめました。
export-ios.sh: Godot で Xcode プロジェクトを書き出すupload-ios.sh:xcodebuild archiveでアーカイブを作成し、xcodebuild -exportArchiveで App Store Connect へアップロードする
Claude Code に「TestFlight にあげて」と指示すると、このスクリプトを実行し、標準出力に Upload succeeded が含まれているかを確認して報告します。成功の文字列を確認させているのは、xcodebuild が内部でアップロードに失敗しても、プロセスの終了コードとして 0 を返す場合があるためです。終了コードだけを見て完了と判断すると、実際にはアップロードが反映されていない事故が生じます。
手動で Xcode を開き操作する手順が不要になったことで、修正内容を実機ですぐに検証したい場面でも、指示を出すだけで作業を進められるようになりました。
スクリプトの整備過程では、いくつかの問題に対処しました。
- 署名の衝突: Godot が出力する Release 構成は、署名方式が Apple Distribution に固定されています。これが Xcode の自動署名機能と競合しました。アーカイブ自体は Apple Development で作成し、配布用の署名は
-exportArchiveの実行時に委ねる手順に変更して解決しました。 - ビルド番号: 同一のビルド番号を二重に送信すると、二回目以降のビルドは TestFlight の一覧に反映されません。エラーも返らないため気付きにくい仕様です。ビルド番号には
202611152203のような日時文字列を自動で割り当て、番号の重複を防ぎました。 - 承認済みのバージョンには上げられない: 審査を通過して承認済みのバージョン番号に対して新しいビルドを追加しようとすると、
Invalid Pre-Release Trainエラーで弾かれます。これ以降は、審査を通過するたびにバージョン番号を繰り上げています。 - アプリの言語: Godot の初期設定では開発言語が英語に固定されており、ストア上の言語表記や端末のシステムメニューが英語になります。書き出し完了後に設定を日本語へ置換する処理をスクリプトに追加しました。前回のビルドのキャッシュが残ると英語の設定に戻ってしまうため、中間ファイルの消去処理も組み込んでいます。
これらの問題は、原因特定に時間を要しやすい性質のものです。調査結果と対処理由はシェルスクリプトのコメント内に記録されているため、以後のビルドで同様の迷いが生じる可能性を低く抑えられます。
Apple Silicon 向けシミュレータ環境の構築
Mac の iOS シミュレータ上で動作を検証する段階で、別の課題が発生しました。Godot 公式の iOS 向けテンプレートには x86_64 向けのライブラリしか含まれておらず、Apple Silicon 搭載の Mac 上で動く iOS シミュレータでは起動できません。
Claude Code は Godot のソースコードを取得し、Apple Silicon のシミュレータ向けにビルドしたうえで、公式テンプレートの構成物と結合するスクリプトを作成しました。初回ビルドには 20 分ほどを要しますが、一度作成すれば、シミュレータ上でのスクリーンショット撮影や動作検証を自動化できるようになります。
実機・シミュレータ特有の入力不具合への対処
シミュレータや実機で検証を進めると、PC 上のテストでは生じなかった不具合が確認されました。チーム名などを入力する画面において、ソフトウェアキーボードの削除キー(Backspace)が反応しない現象です。
調査の結果、キーボード表示時のカーソル位置が原因だと分かりました。モバイル OS のソフトウェアキーボードは、OS 側が仮想的な入力欄を保持し、その変更差分をゲーム側へ送信する機構を持っています。ゲーム側の実装ではキーボードを呼び出した直後にカーソルを末尾へ移動させていましたが、OS 側には呼び出し時点の先頭位置が通知されていました。先頭にカーソルがある状態では消去すべき文字が存在しないと OS が判定し、削除イベントがゲームに送信されなかったためです。
カーソル位置を末尾に指定してからキーボードを呼び出すよう修正し、あわせて変換中の仮名文字で入力上限を超えた際の文字化けや、小型端末でボタンがキーボードに隠れる表示崩れも修正しました。不具合の発生機構と修正理由は、すべてコードのコメントとして記述されています。
ブラウザ自動操作による App Store Connect の入力
App Store Connect へのメタデータ入力は、ブラウザ操作 CLI(agent-browser)を介して Claude Code が担当しました。新規アプリの登録、カテゴリ設定、価格帯、プライバシー情報の回答、説明文やキーワードの入力、スクリーンショットの配置、ビルドの割り当て、審査提出までを一貫して進めています。
App Store Connect の管理画面は入力項目が複数ページに分散しており、提出に必要な未入力項目を一覧で把握しにくい構造です。手作業で進める場合、入力を終えて提出ボタンを押した後に不足項目を指摘され、画面を行き来する手戻りが生じやすくなります。Claude Code は画面要素の状態を解析し、未入力の必須項目を順に特定して埋めていきました。
スクリーンショットの撮影も自動化しました。ゲーム側に起動時引数で任意の画面やゲーム内状態を直接再現する機能を設けており、これを用いて iOS シミュレータ上でレース画面やパドック画面を展開し、要求仕様に合わせた解像度でキャプチャして登録しています。画像の差し替えも指示ひとつで完了するため、伝わりやすい画面構成への更新を即座に試せます。
ただし、ブラウザの自動操作は常に一貫して動作するわけではありません。
- 同一のボタンであっても、日によってクリック操作を受け付けない挙動がありました。DOM 要素の探索によるクリック、JavaScript による
.click()の実行、座標指定によるマウスイベントの発行と、手段を切り替えて処理を通しています。 - バージョン番号の入力フィールドでは、通常のキーストローク送信を行うと既存の値に追記されてしまいました。入力フィールドの値を直接上書きしたうえで入力イベントを発火させる処理に切り替えました。
- 日をまたいで失効したログインセッションに対しては、画面の遷移状態から失効を検知して待機し、作業者へ再ログインを促す処理を挟みました。
これらの回避手順は作業ログに随時書き残されました。申請作業は何日かにわたる進行となるため、セッションを改めた場合でも、前回の到達点や機能した操作手順をログから読み取って作業を再開します。作業者が過去の進捗状況をゼロから確認し直す負担を大幅に減らせます。
人が手を出したところ
すべての工程を自律的に完了できたわけではありません。以下の操作は作業者が担当しました。
- Apple ID のログイン: 二要素認証を伴うログインは毎回作業者が行いました。
- 権利に関わる宣誓: コンテンツ配信権の申告など、法人としての法的な宣誓を要する項目は作業者が選択しました。Claude Code には、意思決定を伴う重要な操作を実行する前に利用者の承認を要求する仕組みが組み込まれています。
- キーチェーンのパスワード: アップロード時のコード署名でパスワード入力ダイアログが表示された際、処理を停止して入力を委ねる場面がありました。
- 契約や銀行口座: 有料アプリの販売契約および振込先口座の設定は、アカウント管理権限を持つ担当者が手続きを進めました。
- 審査への最終提出: 提出は取り消しが難しい操作であるため、実行前に作業者へ承認を求める運用としました。
作業者が審査の提出を指示し、ログインや法的宣誓を作業者が完了させ、画面入力やデータ送信を Claude Code が担当する、という役割分担に落ち着きました。
作業者が引き受けた範囲は「認証による本人の証明」と「会社としての法的な責任」に集約されます。煩雑な入力や調整から解放され、判断と承認の役割に集中できるようになりました。
リジェクト時の原因調査と再提出
審査の過程では、複数回の却下(リジェクト)を経験しています。
最初の却下理由は、情報不足によるものでした(Guideline 2.1)。新規アプリの申請時によく求められる定型の確認であり、実機での操作を記録した動画や、アプリの主目的、外部サービスの利用有無に関する説明を要求されました。回答文は Claude Code が英語で作成し、App Store Connect の審査メモに反映しています。画面構成、ゲームの進行手順、課金や認証の有無、外部通信の発生条件など、審査担当者が求める確認事項に沿った回答を作成しました。実機操作の画面収録のみ作業者が行い、動画ファイルを添付して再提出したところ、承認が得られました。
その後の更新版では、起動時のクラッシュを理由とする却下を受けました。具体的なログが添付されていない自動応答の通知です。手がかりが乏しい状況において、Claude Code は次の検証手順を実行しました。
- TestFlight のクラッシュログ、ならびにビルドごとの起動数・クラッシュ件数を App Store Connect から取得して集計する。
- クリーンインストールされた状態の iPhone および iPad のシミュレータ環境で起動を試す。
- 審査環境の言語設定がクラッシュ要因になり得るため、シミュレータの言語を英語に切り替えて起動する。
- 公式テンプレートではシミュレータ上で Release ビルドを動かせないため、Godot のソースコードからビルドを行い、Release 構成でシミュレータを起動する。
これらの検証環境ではクラッシュを再現できませんでした。そのため、実施した検証手順を審査メモへ英語で記述し、再現端末とクラッシュログの提示を依頼する文面を添えて、新しいビルド番号で再提出を行いました。現時点では審査結果の通知を待っている状態ですが、手元で再現しないリジェクトに対しても、実施済みの検証内容を整理してログの提供を依頼するコミュニケーションを成立させるところまではツール側で完結できました。
申請プロセスの自動化から得られた知見
アプリの申請で負荷となっていた要因は、作業手順の複雑さそのものよりも、多岐にわたる設定項目と、進捗状態の追跡にありました。作業メモの更新を Claude Code が担うことで、作業者が覚えるべき事項はログイン操作と最終確認の承認判断に限定されます。
また、検証済みの範囲と未検証の項目を切り分けて提示する報告形式も、申請業務において有用でした。今回のクラッシュ調査でも、シミュレータ上での再現確認は完了している一方、実機を英語環境にした確認は未実施である旨が明確に示されました。検証済みの事項が切り分けられていれば、作業者は残余のリスクだけを評価できます。不確実な状態で完了報告を受けると、結局すべての項目を人が再点検する結果になります。
コードの実装から、ストアへの提出、審査担当者との対話に至るまで、リリースに関わる工程の多くを AI と協調して進められる環境が整いつつあります。開発者の役割は手作業の遂行から、仕様の決定と要所における承認判断へと移行しています。
GT ROAD は App Store で配信中です。

望月 涼太 / polidog
Co-Founder / Web Engineer
