| name | eas-build |
| description | モバイルアプリのネイティブビルドを EAS Build で実行する。Swift/Kotlin 変更、Widget 変更、ネイティブ依存追加、development build や preview build の作成時に使う。 |
EAS Build
ネイティブコード変更を含むビルドを EAS Build で実行する。
最優先ルール
EAS Build は build credit 消費や従量課金が発生しうる操作として扱う- ユーザーが
buildして preview 向けに作って と依頼していても、それだけでは課金承認と見なさない
eas build を 1 回でも実行する前に、eas account:usage で current cycle の usage を確認するeas build を 1 回でも実行する前に、profile / platform / usage 状態 / 課金リスクを明示してユーザーの明示確認を取る- 今月の残クレジットが不明な場合でも安全側に倒し、
追加課金の可能性あり として確認を取る
--non-interactive --no-wait を含む実コマンド実行は、明示確認の後にしか行ってはいけない- EAS CLI の
100% used 警告は build 開始後に出ることがあるので、CLI 警告を課金確認の代わりにしてはいけない
eas account:usage に遅延や取得失敗の可能性があるため、usage 確認は必須だが、それだけで安全と見なしてはいけない
手順
- profile と platform を決める。
- profile:
preview または development
- platform:
ios / android / all
apps/mobile/.env を読み込んだ状態で eas account:usage を実行する。
- この repo では
.env を読み込まないと project / account 解決で失敗しやすい
- PowerShell 直実行より、
bash -lc で .env を export してから叩く
bash -lc "cd apps/mobile && set -a && source .env && set +a && eas account:usage <account-name> --json"
builds.plan.percentUsed >= 100 の時点で、build は追加課金状態として扱う- usage が取得できない時点でも、build は追加課金リスクありとして扱う
- 実行前にユーザーへ確認する。
- 伝える内容は
profile platform usage 状態 追加課金の可能性 の 4 点を最低限含める
- ユーザーの明示承認があるまで、build コマンドは実行しない
apps/mobile/.env を読み込んだ状態で eas build を実行する。
- この repo では
app.config.ts が BUNDLE_ID、EAS_PROJECT_ID、EAS_OWNER を process.env から読む
- PowerShell 直実行より、
bash -lc で .env を export してから叩く方が安全
bash -lc "cd apps/mobile && set -a && source .env && set +a && eas build --profile <profile> --platform <platform>"
-
shell 実行は長時間になるので、十分長い timeout_ms を付ける。
-
結果から Build ID と Dashboard URL を拾って報告する。
使い分け
development: dev client 用preview: 内部配布や実機確認用- JS/TS だけの変更なら OTA Update を検討する
注意事項
.env の読み込みを飛ばすと EAS project not configured で失敗する- EAS の無料枠と待ち時間が大きいので、ローカルで潰せるエラーは先に潰す
eas account:usage は current cycle の usage 確認に使える- Expo docs では billing estimate に最大 24 時間の遅延がありうるとされているので、usage が 100% 未満でも課金リスク説明は省略しない
- EAS Build 実行前に、build credit 消費や従量課金の可能性を明示し、必ずユーザーの明示確認を取る
- 課金警告や credit 超過警告が出た場合は、その場で停止し、ユーザー確認なしに続行しない
- ユーザーの承認を得て build を開始した後に課金警告が出た場合は、その警告内容を結果として明示して報告する
- ネイティブ変更がないなら
.codex/skills/ota-update/SKILL.md を優先する
