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

スマホからAIに指示して、iOSアプリの開発からTestFlight配信まで回せる仕組みを作った件

    はじめに

    久々の記事更新になりますが、最近は公私共に多忙で、中々iOSアプリの開発に時間を割けない、もしくは疲労でPC前に座る気力もありません😇

    そこで、スマホアプリからAIエージェントに「この機能を直して、テスト版を配信して」と指示する。コードの修正からビルド、TestFlightへの配信まで進めて、同じスマホで動作を確かめる。そんな開発の流れを作りたいと思っていました。

    AIエージェントがGitHub上のコードを更新できても、実機で試すたびにMacを開いてビルドする必要があると、平日は仕事に追われて、土日も子供の用事などで中々進みません🫠
    今回はその間をつなぐため、Xcode CloudでネイティブのiOSアプリをビルドし、TestFlightへ自動配信する仕組みを整えました。

    作った流れは、次のとおりです。

    1. スマホアプリからAIエージェントへ開発・修正を指示する。

    2. AIエージェントがコードを修正し、確認した内容をGitHubへ送る。

    3. 配布する版にタグを付けると、Xcode Cloudがビルドを始める。

    4. 完成したアプリがTestFlightに届き、iPhoneで試せるようになる。

    5. 指示するAIエージェントはクラウド環境が使えるものならなんでも

      1. 現在は、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をつないでいきます。

    画像
    設定前のXcode Cloud一覧。対象アプリはまだ登録されていません。

    2. 初回だけ、Xcodeからワークフローを登録する

    まずは、GitHubのどのプロジェクトをビルドするかをXcode Cloudに登録します。この初回設定を済ませておくことで、以後の配布をクラウド側へ任せられるようにします。

    Xcode 26.3で対象アプリのプロジェクトを開き、メニューの「Integrate」→「Create Workflow…」へ。対象のアプリ名とBundle Identifierを確認して進みます。

    画像
    Cloudに登録する製品を選択。アプリ名とBundle Identifierを確認します

    3. 初期設定のままでは、TestFlight配布までは届かない

    最初の「Review Workflow」には、mainブランチの変更をきっかけにアーカイブを作る設定が表示されました。下のPost-Actionsは「No TestFlight Deployments or Notifications」。

    あ、配布はまだ設定されていないんだ。画面に出ている内容を見て、作る処理と届ける処理を分けて確認できました。

    画像
    初期提案にはアーカイブがありますが、TestFlight配布は入っていません。

    4. GitHubのリポジトリと、配布先のアプリをつなぐ

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

    画像
    今回の環境ではGitHubの対象リポジトリが接続済みでした。

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

    画像
    App Store Connectのアプリ名とBundle Identifierを確認して登録します。
    画像
    Cloudへの登録完了。配布設定とビルド番号を整えてから最初のビルドを始めます。

    5. 最初のビルドを始める前に、番号と開始条件を整える

    登録直後のCloudは、次のビルド番号が「1」になっていました。対象アプリはすでにビルド14をアップロードしているので、App Store Connectの「Xcode Cloud」→「対象アプリ」→「設定」→「ビルド番号」で、次を「15」に変更します。

    画像
    既存ビルド14に続く番号として、Cloudの次回を15に設定しました。

    開始条件は、AIエージェントがGitHubへ配布用のタグを送ると、自動でビルドが始まる形にしました。

    • 手動開始:任意のブランチ、または「testflight-」で始まるタグ。

    • 自動開始:「testflight-」で始まるタグの変更。

    • 初期設定にあったmainブランチ更新時の自動開始は外す。

    ここでのタグは、配布したいコードの版に付ける目印です。記事や説明文だけの更新で毎回ビルドするのではなく、配布したいときに目印を付ける運用にしました。

    タグの設定画面では、文字列を入れた後に「以下で始まるタグ…」の候補を選びます。「testflight-」という完全一致のタグを選ぶ項目も別にあるので、ここは画面を見て確認しました。

    画像
    手動開始と、testflight-で始まるタグの自動開始を設定。

    6. アーカイブの後に、内部テストへの配布を追加する

    「ワークフロー」のアーカイブ設定で、プラットフォームはiOS、スキームは対象アプリの共有スキーム、配信準備は「TestFlight(内部テストのみ)」にします。さらにPost-Actionsへ「TestFlight内部テスト」を追加し、成果物としてiOSのアーカイブ、配布先として既存グループの「自分のみ」を指定して保存。

    今回作るのは自分のiPhoneで試すための内部テスト用ビルドです。App Store審査へ提出するためのビルドとは用途が違います。設定を再現する場合は、Apple公式のTestFlight配布手順も確認できます。

    画像
    アーカイブだけで終わらせず、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側の大まかな失敗表示だけで止まらず、TestFlightのアップロード履歴で理由を確認。

    Cloudのビルド番号を15に上げても、アプリのVersionは2.0のまま。ここで増やすべき番号が、もう一つありました。

    今回はアプリとテストターゲットのバージョンを2.0.1へ更新。アプリの機能は変えず、次のバージョンとしてアップロードし直します。

    画像
    Versionを2.0.1へ更新。画面のBuildは手元の値で、Cloudは別途16を自動採番します。

    修正をGitHubの作業ブランチへ送り、そこに「testflight-20261017-01」というタグを付けてpush。設定した開始条件が働き、Cloudのビルド16が自動で始まりました。手動開始だけでなく、タグからの開始もここで確認できました。

    成果物:CloudからTestFlightのグループまで届いた

    ビルド16は、成功しました。Cloud上でArchiveとTestFlight内部テストの両方に緑のチェックが付きました。今回は開始から約7分です。

    画像
    タグから始まったビルド16。アーカイブとTestFlight配布の両方が成功。

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

    画像
    TestFlightでもビルド16がテスト準備完了になりました。

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

    画像
    自分を追加して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を受け取れる環境構築が出来てからというもの、子育てのスキマ時間、通勤時間のスキマ時間、就寝前などでも、スマホからポチポチ修正指示を送るだけで、大体の開発と実機検証まで回せるようになりました👍️



     
     
    小学生育児中のフルタイム社畜会社員。本業はWEBやAPPのPM歴約8年。AI開発は、勉強半分、趣味半分、少しの副業昇格野望。個人開発4ヶ月目でようやくゼロイチ達成🎉 最近はiOSアプリ開発メイン。 #株クラ に入りたい。個人総資産約3000万、インデックス長期投資メイン。

    あなたへのおすすめ