はじめに

現在、React Native (Expo) を使ってパーソナルAIエージェントアプリを開発しています。

開発が進み、社内検証やベータテストのためにTestFlight（App Store Connect）へアプリをアップロードしようとした際、いくつかの配信パターンがあることを知りました。

Expoが提供する EAS Build を使えばコマンド一発でクラウドビルドから配信まで完結して便利なのですが、無料枠（Freeプラン）だと月のビルド回数や並列処理に上限があり、頻繁にデバッグビルドを回しているとあっという間に枠を使い切ってしまいます。

この記事では、無料枠の枯渇対策も含めて、「React NativeアプリをTestFlightに反映するまでの3つのパターン」 を備忘録としてまとめます。

対象読者

まずは、Expoの恩恵を最大限に受けられるパターンです。
証明書の管理などもEAS側で良しなにやってくれるため、Macを持っていなくても（Windowsからでも）iOSビルドが可能です。

eas.json の設定に基づき、用途に合わせて以下のコマンドを実行します。
キャッシュが原因の謎エラーを防ぐため、念のため --clear-cache をつけておくのがおすすめです。

【開発用（Dev）プロファイルでのビルド】

npx eas build --profile development --platform ios --clear-cache

【本番用（Prod / TestFlight）プロファイルでのビルド】

npx eas build --profile production --platform ios --clear-cache

ビルドが完了し、.ipa ファイルが生成されたら、以下のコマンドでApp Store Connectへ自動アップロードします。

npx eas submit --profile production --platform ios

※インタラクティブなプロンプトに従って、アップロードしたいビルドIDを選択するだけで完了します。

EASの無料枠を使い切ってしまった場合や、手元のMacのスペックが高くてクラウドより早くビルドが終わる場合は、こちらの「ローカルビルド」を採用します。

ExpoのManaged Workflowで開発している場合、まずはネイティブの ios ディレクトリを生成（または初期化）します。

npx expo prebuild --platform ios --clean

※ --clean をつけることで、既存の ios フォルダを破棄して真っ更な状態から再生成してくれます。
※ 不要なキャッシュや依存関係のズレをリセットできるため、リリース前には必ず実行しています。

生成された .xcworkspace を以下のコマンドで開きます。

xed ios

ここからはXcodeのGUI操作になります。

右側の [Distribute App] ボタンをクリックし、[App Store Connect] を選択して画面の指示に従いアップロード（Upload）します

すでに .ipa ファイルが手元にある場合（EASからipaだけダウンロードした場合や、過去のビルドファイルを再アップロードしたい場合）、Apple公式アプリの Transporter を使ってアップロードできます。

ターミナルコマンド（eas submit や xcrun altool）に抵抗がある方や、ネットワークエラー等でCLIからのアップロードが途中でコケてしまった時の代替手段として便利です。

Expoの EAS Build は便利ですが、検証段階などで「無料枠の壁」や「謎のビルドエラー」にぶつかります。

そんな時、「いざとなれば prebuild してXcodeから直接Archiveできる」 という選択肢を持っておくことで、開発を止めずに検証やリリースを進めることができます。