
スマホからAIに指示して、iOSアプリの開発からTestFlight配信まで回せる仕組みを作った件
はじめに
久々の記事更新になりますが、最近は公私共に多忙で、中々iOSアプリの開発に時間を割けない、もしくは疲労でPC前に座る気力もありません😇
そこで、スマホアプリからAIエージェントに「この機能を直して、テスト版を配信して」と指示する。コードの修正からビルド、TestFlightへの配信まで進めて、同じスマホで動作を確かめる。そんな開発の流れを作りたいと思っていました。
AIエージェントがGitHub上のコードを更新できても、実機で試すたびにMacを開いてビルドする必要があると、平日は仕事に追われて、土日も子供の用事などで中々進みません🫠
今回はその間をつなぐため、Xcode CloudでネイティブのiOSアプリをビルドし、TestFlightへ自動配信する仕組みを整えました。
作った流れは、次のとおりです。
スマホアプリからAIエージェントへ開発・修正を指示する。
AIエージェントがコードを修正し、確認した内容をGitHubへ送る。
配布する版にタグを付けると、Xcode Cloudがビルドを始める。
完成したアプリがTestFlightに届き、iPhoneで試せるようになる。
指示するAIエージェントはクラウド環境が使えるものならなんでも
現在は、CursorProjectかCodexのCloud、もしくはリモートコントロールを使ってます
この記事は、そのための初回設定と配信の動作確認の記録です。既にいくつかのアプリで設定済だったのですが、アプリ毎に毎回設定が必要です。現在公開中の15本のアプリの中でも、注力中の5本目にして、ようやく手順が固まってきたので、その5本目の初回Xcode Cloud登録時についでに記事にしてみました。
アプリ名・GitHubのリポジトリ名・識別子・アイコンは伏せています。
1. スマホから配信までつなぐため、Cloudの設定を確認する
App Store ConnectのTestFlightには、すでに2.0のビルド14がありました。一方、Xcode Cloudの登録一覧には対象アプリがありません。
TestFlightにビルドがあることと、GitHubの更新から自動配信できることは別です。スマホからAIエージェントに指示した後、そのまま配信まで進めるために、GitHubとXcode Cloudをつないでいきます。

2. 初回だけ、Xcodeからワークフローを登録する
まずは、GitHubのどのプロジェクトをビルドするかをXcode Cloudに登録します。この初回設定を済ませておくことで、以後の配布をクラウド側へ任せられるようにします。
Xcode 26.3で対象アプリのプロジェクトを開き、メニューの「Integrate」→「Create Workflow…」へ。対象のアプリ名とBundle Identifierを確認して進みます。

3. 初期設定のままでは、TestFlight配布までは届かない
最初の「Review Workflow」には、mainブランチの変更をきっかけにアーカイブを作る設定が表示されました。下のPost-Actionsは「No TestFlight Deployments or Notifications」。
あ、配布はまだ設定されていないんだ。画面に出ている内容を見て、作る処理と届ける処理を分けて確認できました。

4. GitHubのリポジトリと、配布先のアプリをつなぐ
ワークフロー名は、対象アプリのTestFlight用だと分かる名前に変更しました。続いてGitHubへの接続を確認。今回は既存の接続が使え、対象リポジトリに緑のチェックが表示されました。初めて設定する環境では、ここの表示や必要な操作が変わる場合があります。

次に、App Store Connect上の対象アプリと紐づくことを確認。「Complete」を押すと、Xcode Cloudへの登録完了画面になりました。


5. 最初のビルドを始める前に、番号と開始条件を整える
登録直後のCloudは、次のビルド番号が「1」になっていました。対象アプリはすでにビルド14をアップロードしているので、App Store Connectの「Xcode Cloud」→「対象アプリ」→「設定」→「ビルド番号」で、次を「15」に変更します。

開始条件は、AIエージェントがGitHubへ配布用のタグを送ると、自動でビルドが始まる形にしました。
手動開始:任意のブランチ、または「testflight-」で始まるタグ。
自動開始:「testflight-」で始まるタグの変更。
初期設定にあったmainブランチ更新時の自動開始は外す。
ここでのタグは、配布したいコードの版に付ける目印です。記事や説明文だけの更新で毎回ビルドするのではなく、配布したいときに目印を付ける運用にしました。
タグの設定画面では、文字列を入れた後に「以下で始まるタグ…」の候補を選びます。「testflight-」という完全一致のタグを選ぶ項目も別にあるので、ここは画面を見て確認しました。

6. アーカイブの後に、内部テストへの配布を追加する
「ワークフロー」のアーカイブ設定で、プラットフォームはiOS、スキームは対象アプリの共有スキーム、配信準備は「TestFlight(内部テストのみ)」にします。さらにPost-Actionsへ「TestFlight内部テスト」を追加し、成果物としてiOSのアーカイブ、配布先として既存グループの「自分のみ」を指定して保存。
今回作るのは自分のiPhoneで試すための内部テスト用ビルドです。App Store審査へ提出するためのビルドとは用途が違います。設定を再現する場合は、Apple公式のTestFlight配布手順も確認できます。

ところが、グループの人数を見ると「0人」。名前が「自分のみ」でも、自分が入っているとは限らないんですねw。配布先の指定だけで終わらず、実際に受け取るテスターがいるかまで確認する必要がありました。
7. まずはGitHubのmainから、Cloudビルドを実行
App Store Connectの「ビルド」→「ビルドを開始」へ進み、対象アプリのTestFlight用ワークフローを選択します。次の画面ではmainを選び、実行しました。

今回Cloudが取得したのは、直近の機能追加をmainへ取り込んだコミットです。手元のMacに残っている未コミットの変更ではなく、GitHubにあるコードが対象になっています。
Cloud上のビルド番号は15。ここから先は、アーカイブ成功と、TestFlight側で使える状態になったことをそれぞれ確認します。
8. ビルドは通ったのに失敗。原因は「2.0の受付終了」
最初のビルド15は、失敗しました😇
ログを見るとコードのアーカイブも書き出しも成功しています。でも最後の表示は「Preparing build for App Store Connect failed」。これだけだと、何を直せばよいのか分からない。
具体的な理由は、TestFlightのアップロード履歴にありました。失敗した行の「失敗」を押すと、エラー90062と90186が表示されます。
承認済みの2.0より高いバージョンが必要。
2.0のバージョン枠は、新しいビルドの受付を終了している。

Cloudのビルド番号を15に上げても、アプリのVersionは2.0のまま。ここで増やすべき番号が、もう一つありました。
今回はアプリとテストターゲットのバージョンを2.0.1へ更新。アプリの機能は変えず、次のバージョンとしてアップロードし直します。

修正をGitHubの作業ブランチへ送り、そこに「testflight-20261017-01」というタグを付けてpush。設定した開始条件が働き、Cloudのビルド16が自動で始まりました。手動開始だけでなく、タグからの開始もここで確認できました。
成果物:CloudからTestFlightのグループまで届いた
ビルド16は、成功しました。Cloud上でArchiveとTestFlight内部テストの両方に緑のチェックが付きました。今回は開始から約7分です。

TestFlight側にも「バージョン2.0.1」「ビルド16」「内部」「テスト準備完了」が表示され、配布先グループにも紐づいています。やった、ここまで動いた!

最後に、自分のアカウントを「自分のみ」グループへ追加しました。追加前にもう一度確認すると0人だったので、受け取るための設定もここで整えます。「1人のテスター」「招待済み」まで確認できました。

ここまでで、タグのpushをきっかけにしたCloudビルド、TestFlightの配布先グループへの登録、自分のテスター招待まで確認できました。iPhoneへのインストールと実機での操作確認は、この後に行います。
再実行の手順はリポジトリのREADMEに残しました。今後はスマホアプリからAIエージェントへ修正と配信を指示し、GitHubへ反映した版に「testflight-」で始まる新しいタグを付けてもらえば、Cloudでビルドが始まります。毎回Macでアーカイブしてアップロードする操作を、この流れに置き換えられます。
ストア入稿の素材と認証情報も、GitHub側に用意する
スマホから開発を進めるには、コードだけでなく、ストアへ届けるための素材と入稿手順もAIエージェントが扱える場所に必要です。
App Store掲載用のスクリーンショットや説明文などの入稿素材も、GitHubのリポジトリで管理しています。素材や文面を更新し、FastlaneでApp Store Connectへ入稿する処理も用意しています。
この入稿処理で使うApp Store Connect APIのシークレットキーは、GitHub Secretsに登録して管理しています。鍵の中身をソースコードに書かず、クラウド上で入稿処理を実行するときに認証情報を渡すためです。スクショなどの素材はリポジトリ、秘密鍵はSecretsに置く、という分け方です。
アプリ本体のビルドとTestFlight配信はXcode Cloud、ストア掲載用のスクショや説明文の入稿はFastlaneが担当します。今回動作確認したのはTestFlightの内部配信までですが、入稿側も含めてGitHubを起点に扱えるようにしておくことで、スマホから指示できる作業の範囲を広げています。
まとめ
今回作ったのは、スマホアプリからAIエージェントへ指示して、ネイティブアプリの開発からTestFlight配信まで進めるための仕組みです。GitHubにあるコードへ配布用のタグを付けると、Xcode Cloudがビルドし、TestFlightの内部テストへ届けるところまでの設定です。
途中でバージョン番号によるアップロードエラーもありましたが、修正後はタグからの自動開始と配布が成功。
コードを直せるだけでなく、スマホでTestFlightを受け取れる環境構築が出来てからというもの、子育てのスキマ時間、通勤時間のスキマ時間、就寝前などでも、スマホからポチポチ修正指示を送るだけで、大体の開発と実機検証まで回せるようになりました👍️