Xcode Cloud

Xcode Cloud のビルドを確認し、開始できます。対象は、プロダクト、そのワークフロー、そして各ビルド実行とそのアクション、問題、テスト結果、アーティファクトです。

プロダクトは、Xcode で初めてリポジトリを接続したときに作成されます（Integrate > Create Workflow）。API でプロダクトを作成することはできません。作成後は、このページの操作をすべてコマンドラインから行えます。プロダクトはアプリの Bundle ID（またはエイリアス）、名前、ID のいずれかで、ワークフローは名前または ID で、ビルド実行は番号または ID で指定します。

プロダクト

ascelerate xcode-cloud products

チームのプロダクト（アプリとフレームワーク）を、Bundle ID とリポジトリとともに一覧表示します。

ワークフロー

ascelerate xcode-cloud workflows <bundle-id>
ascelerate xcode-cloud workflows info <bundle-id> "Release"
ascelerate xcode-cloud workflows update <bundle-id> "Default" --manual-only
ascelerate xcode-cloud workflows update <bundle-id> "Release" --branch-changes "main,release/*" --xcode "Xcode 27.2" --clean false
ascelerate xcode-cloud workflows create <bundle-id> --like "Default" --name "TestFlight" --action archive:MyApp:ios --manual-branches main
ascelerate xcode-cloud workflows disable <bundle-id> "Nightly"
ascelerate xcode-cloud workflows enable <bundle-id> "Nightly"
ascelerate xcode-cloud workflows delete <bundle-id> "Old workflow"

info は、ワークフローの開始条件（ブランチやタグの変更、プルリクエスト、スケジュール、手動で開始できる対象）、アクション（ビルド、テスト、解析、アーカイブと、それぞれのスキーム、プラットフォーム、配布方法）、使用するリポジトリ、プロジェクト、Xcode と macOS のバージョンを表示します。update --manual-only は、ワークフローが自動で開始しないようにします（ブランチやタグの変更、プルリクエスト、スケジュール）。手動で開始できる対象はそのまま残ります。update では、名前、説明、クリーンビルド、「Restrict Editing」、Xcode と macOS のバージョン、各開始条件も変更できます。--branch-changes、--tag-changes、--pull-requests（--pull-request-source と組み合わせ）、--manual-branches、--manual-tags、--manual-pull-requests には名前（前方一致は release/*）、any、off を指定します。--auto-cancel と --remove-schedule も使えます。保存の前に変更点を表示して確認します。--action TYPE:SCHEME[:PLATFORM]（複数指定可）はアクションを置き換え、--distribution internal|app-store|none はアーカイブの配信先を設定します。create は別のワークフローのコピーとして新しいワークフローを作成し（--like。プロダクトのワークフローが1つだけなら不要）、同じオプションを使えます。API には環境変数とポストアクションがないため、それら（TestFlight グループなど）は App Store Connect で追加してください。無効にしたワークフローはビルドを開始しません。ワークフローを削除しても、そのビルド実行は残ります。

ビルド実行

ascelerate xcode-cloud runs <bundle-id>                         # 新しい順
ascelerate xcode-cloud runs <bundle-id> --workflow "Release" --limit 50
ascelerate xcode-cloud runs info <bundle-id> 42                 # 詳細とアクション
ascelerate xcode-cloud runs issues <bundle-id> 42 [--errors]
ascelerate xcode-cloud runs tests <bundle-id> 42 [--failed]
ascelerate xcode-cloud runs logs <bundle-id> 42 [--action "Build - iOS"] [--show ci_post_clone.log]
ascelerate xcode-cloud runs artifacts <bundle-id> 42
ascelerate xcode-cloud runs artifacts <bundle-id> 42 --type LOG_BUNDLE --download ./logs

各ビルド実行には、状態、ビルドしたブランチ・タグ・プルリクエスト、コミット、所要時間が表示されます。runs info では各アクションのエラー・警告・失敗したテストの件数も表示されます（Apple は件数を返さないため、各アクションの問題から数えます）。App Store Connect にアップロードしたアーカイブでは、アップロードされたビルドとその処理状況、TestFlight の状態も表示されます。issues は各アクションのエラーと警告をファイルと行番号とともに一覧表示します。tests はテスト結果を実行先（デバイスと OS）ごとに一覧表示し、失敗したテストにはそれぞれ失敗メッセージを添えます。logs は各アクションのログバンドルを読み込み、post-clone スクリプト、パッケージの解決、xcodebuild のログを行数とともに一覧表示します。--show で内容を表示できます。artifacts はログ、アーカイブ、結果バンドル、プロダクトを一覧表示します。--download でそれらを保存でき、--type で対象を絞り込めます。

ビルドの開始

ascelerate xcode-cloud start <bundle-id> "Release" --branch main
ascelerate xcode-cloud start <bundle-id> "Release" --tag v2.1
ascelerate xcode-cloud start <bundle-id> "PR checks" --pull-request 128
ascelerate xcode-cloud rerun <bundle-id> 42 [--clean]

start は指定したブランチ、タグ、またはプルリクエストをビルドします。指定しない場合、Xcode Cloud はワークフローの開始条件で手動開始が許可されている対象をビルドします。rerun は以前のビルド実行のコミットを、同じワークフローで再度ビルドします。--clean を指定するとキャッシュを使わずにビルドします。API からビルドをキャンセルすることはできません。

リポジトリと Xcode のバージョン

ascelerate xcode-cloud repositories
ascelerate xcode-cloud xcode-versions

xcode-versions は、Xcode Cloud で利用できる Xcode のバージョンを、それぞれが動作する macOS のバージョンとともに一覧表示します。

一覧表示と詳細表示のコマンドはすべて --json に対応しています。