Xcodebuild

Overview

xcodebuild についてまとめているセクション。

xcodebuild は Xcode のプロジェクトやワークスペースを使って、ビルド、アーカイブ、テスト、エクスポートなどを行うための CLI ツール。
- 例: xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -archivePath ... archive
- 主に **ビルド・アーカイブ・エクスポートなど「Xcodeプロジェクト操作」**に使う。
xcrun は Xcode に付属するコマンド群（例：simctl, iTMSTransporter, notarytool など）を呼び出すためのランチャー的な CLI ツール。
- 例: xcrun iTMSTransporter -m upload -f build/ios/ipa/client.ipa -u $APPLE_ID -p $APP_SPECIFIC_PASSWORD
- App Store Connect へのアップロード、シミュレータ制御、notarization など周辺機能を呼び出す役割がある。

App Store 誤配信のリスクを防げる
- App Store 配信候補にならないため、誤って審査や本番申請につながる心配がない。
社内・内部テスターのみに限定配布できる
- 意図しない外部テスターやユーザーに配信されることを防げる。
審査不要・即時配信
- 外部テストと違い Apple の審査が不要。アップロード後すぐに配布が可能。
CI/CDでの安全なビルド運用
- distributionDestination に internal を指定することで、CIでも明示的に社内向けビルドとして扱える。
🧩 ステージングや段階的なビルド管理がしやすい
開発用・検証用・リリース候補とビルドの用途を明確に区分できる。

TestFlight にアップロードしたビルドはすべてに使える汎用的なビルドであり、開発中の社内ビルドを誤って外部公開候補にしてしまうリスクがあった。
そのため「審査通過可能な状態に近くないとアップロードしづらい」という制約が間接的にあった。