用途:通过 App Store Connect API 管理 Xcode Cloud 的产品、工作流和构建运行,适合在命令行或脚本中触发与查看 CI 构建。
主要能力:列出产品、列出工作流、启动构建、查询构建状态、查看近期构建列表,以及执行清理构建(清除派生数据)。
使用方式:先认证,命令为 asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8。每个 JSON 响应含 affordances 字段,提供已填好 ID 的下一步命令,可直接运行,无需手动复制 ID。典型流程:asc xcode-cloud products list --app-id 6443417124 --pretty,再运行响应中的 listWorkflows 命令,最后运行目标工作流的 startBuild 命令。也可用脚本配合 jq 提取 ID 后启动构建。
状态判断:构建的 executionProgress 为 PENDING、RUNNING 或 COMPLETE;仅当 COMPLETE 时查看 completionStatus,取值为 SUCCEEDED、FAILED、ERRORED、CANCELED 或 SKIPPED。
限制:startBuild 仅在 workflow 的 isEnabled 为 true 时出现,禁用工作流无法触发。完整命令与参数见 commands.md。其他细节暂未提供。