【免费下载链接】App-Store-Connect-CLIFast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions, and more项目地址https://gitcode.com/gh_mirrors/ap/App-Store-Connect-CLI点击查看免费下载asc xcode build是 App-Store-Connect-CLI以下简称 asc本地xcode命令组下的一个一等公民子命令用于直接包装xcodebuild ... build动作完成模拟器或真机 Scheme 的普通编译检查。它不做 archive、export、upload也不调用 App Store Connect因此非常适合在 CI 与本地开发中替代手写xcodebuild或误用asc xcode archive的做法。读完本文你将掌握该命令的完整参数面、派生数据缓存路径的确定规则、结构化输出字段以及它与其他xcode子命令archive / export / validate之间的边界和取舍。定位为什么需要一等公民的 build 子命令在引入该命令之前asc xcode --help只暴露了inject、archive、export、export-options、validate、version等子命令。模拟器/真机的编译检查因此只能走两条弯路直接裸调xcodebuild或者误用asc xcode archive。前者丢失了 asc 提供的参数校验与结构化输出后者则执行了完全不同语义的工作生成.xcarchive。asc xcode build的设计目标就是补上这个空白一个可发现、可校验、输出稳定的普通编译入口。从源码看XcodeCommand()见 internal/cli/xcode/xcode.go在Subcommands列表中注册了XcodeBuildCommand()与XcodeArchiveCommand()、XcodeExportCommand()、XcodeValidateCommand()等并列。命令组的长帮助文本LongHelp也把asc xcode build --project ... --destination ... --no-code-signing --output json列为官方示例并明确说明 build/archive/export 三个命令均只在 macOS 上受支持。命令组的整体语义边界在 internal/cli/xcode/xcode.go 中写得很清楚build / archive / export 包装本地xcodebuild流程仅在 macOS 上支持signing plan 等辅助命令跨平台signing apply 在 Windows 上会先失败关闭这些本地命令的目的是编译项目、产出确定性的.xcarchive、.ipa、.pkg路径供后续asc upload/asc publish直接消费。调用形态与完整参数面设计文档给出了基准调用形态下面将其完整展开并补充每个参数的实际语义参数定义见 internal/cli/xcode/build.goasc xcode build \ --project App.xcodeproj \ --scheme App \ --configuration Debug \ --destination platformiOS Simulator,nameiPhone 17 Pro Max,OS27.0 \ --no-code-signing \ --output json请把示例中的 destination 替换为当前主机实际安装的模拟器例如先运行asc xcode test-destinations --platform iOS --available-only --output json或xcodebuild -showdestinations查看可用列表。参数类型必填说明--project/--workspacestring二者恰好其一分别指向.xcodeproj或.xcworkspace目录两者同时提供或同时缺失都会报错--schemestring是Xcode scheme 名称--configurationstring否构建配置如Debug/Release--destinationstring否Xcode destination 描述符如platformiOS Simulator,nameiPhone 17 Pro Max,OS27.0或generic/platformiOS--derived-data-pathstring否DerivedData 目录省略时使用 asc 推导的稳定缓存路径--result-bundle-pathstring否新建.xcresult结果包的绝对目标路径要求目标必须尚不存在--cleanbool否在 build 之前先执行clean--no-code-signingbool否显式追加CODE_SIGNING_ALLOWEDNO--xcodebuild-flagrepeatable否逐个追加为独立进程参数与 archive/export 相同的“无 shell 直通”模型--output/--prettystring / bool否结构化输出格式json / table / markdown 等由shared.BindOutputFlags绑定位置参数不被接受CLI 层在Exec入口会先检查len(args) 0并报xcode build does not accept positional arguments见 internal/cli/xcode/build.go。命令还拒绝“显式传入但为空”的--configuration、--destination、--derived-data-path、--result-bundle-path因为一个被置空的 CI 变量与“未提供该参数”绝不是同一次请求firstExplicitlyEmptyFlag的实现位于 internal/cli/xcode/xcode.go。参数校验发生在任何副作用之前ValidateBuildOptions()见 internal/xcode/build.go只做确定性的“命令形态”检查不读文件系统、不起子进程包括project/workspace 二选一validateWorkspaceProjectPair--scheme必填--project必须以.xcodeproj结尾、--workspace必须以.xcworkspace结尾大小写不敏感空白的--xcodebuild-flag被拒绝直通参数不能覆盖 asc 管理的参数见下文。CLI 层随后才做空值检查与输出格式校验见 internal/cli/xcode/build.go。测试TestValidateBuildOptions见 internal/xcode/build_test.go逐条覆盖了上述错误分支。行为与输出派生数据路径确定性优先显式路径总是优先省略--derived-data-path时asc 会基于“项目/工作区的绝对路径 scheme configuration destination”推导出一个位于源码检出目录之外的稳定缓存路径。实现见resolveBuildDerivedDataPath()internal/xcode/build.go取用户缓存目录os.UserCacheDir对绝对项目/工作区路径 scheme configuration destination做 SHA-256 摘要取前 12 位十六进制拼成{cacheDir}/asc/xcode-build/{sanitized-scheme}-{hash}其中 scheme 会被safeBuildPathComponent规整非字母数字转为-最长 48 个字符按 rune 边界截断见 internal/xcode/build.go。测试TestResolveBuildDerivedDataPathIsStableAndOutsideProject见 internal/xcode/build_test.go验证了三点同一组输入两次解析结果一致稳定路径前缀在asc/xcode-build/之下且不在源码检出目录内destination 变化会导致路径变化。TestSafeBuildPathComponentTruncatesOnRuneBoundary同文件第 304-312 行则保证多字节字符截断后仍是合法 UTF-8。显式提供的--derived-data-path与--result-bundle-path都会先解析为绝对路径filepath.AbsClean并且显式路径总是胜出。result bundleasc 绝不删除或覆盖--result-bundle-path是可选的.xcresult输出目标。validateBuildResultBundleDestination()internal/xcode/build.go用os.Lstat检查目标已存在则直接报错--result-bundle-path already existsasc 从不删除、覆盖任何已有文件。--no-code-signing是显式选择不做“聪明的猜测”--no-code-signing只是在 argv 中追加CODE_SIGNING_ALLOWEDNO。它不会因为 destination 看起来像模拟器就自动关闭签名——设备构建始终保留 Xcode 的正常签名行为除非操作者显式退出。这一点在buildBuildCommand()internal/xcode/build.go和测试TestBuildCommandDoesNotChangeSigningByDefaultinternal/xcode/build_test.go中都有体现默认情况下CODE_SIGNING_ALLOWEDNO绝不出现且参数列表最后一个参数永远是build动作。argv 组装顺序与空格保留buildBuildCommand()按固定顺序组装进程参数-workspace/-project→-scheme→-configuration→-destination→-derivedDataPath→-resultBundlePath→ 直通参数 →CODE_SIGNING_ALLOWEDNO若启用→clean若启用→build。测试TestBuildCommandUsesTypedOptionsAndPreservesRawArgumentsinternal/xcode/build_test.go用一个含空格的值Demo App.xcworkspace、Release Candidate验证了空格与顺序均被原样保留——参数始终以 argv 切片传递从不经过 shell。直通参数不能覆盖 asc 管理的参数--xcodebuild-flag可以追加任意普通 xcodebuild 参数或 build setting例如-quiet、SWIFT_ACTIVE_COMPILATION_CONDITIONSCI、OTHER_SWIFT_FLAGS[sdkiphonesimulator*]-DASC_BUILD但绝不能覆盖 asc 管理的参数。reservedBuildPassthroughArgument()internal/xcode/build.go维护了一张宽名单覆盖asc 管理的选择器与路径参数-project、-workspace、-scheme、-target、-alltargets、-configuration、-destination、-deriveddatapath、-resultbundlepath、-archivepath等所有 xcodebuild 动作build、build-for-testing、analyze、archive、test、test-without-building、docbuild、installsrc、installhdrs、install、clean防重名覆盖由 CLI 追加的动作操作模式参数-dry-run、-usage、-help、-license、-showsdks、-showdestinations、-list、-version、-create-xcframework等受管 build settingaction、code_signing_allowed含value与[config...]条件形式匹配大小写不敏感。命中任意一条都会返回--xcodebuild-flag cannot override asc-managed argument %q保证“报告的结果保持真实”——asc 报告什么xcodebuild 就实际执行了什么。测试TestValidateBuildOptionsRejectsEveryXcodebuildAction、TestValidateBuildOptionsRejectsXcodebuildOperationModes以及TestValidateBuildOptionsRejectsEveryArgumentBuildEmitsinternal/xcode/build_test.go用完整动作/操作清单与命令实际会 emit 的每个参数做双向校验防止名单漂移。结构化结果与退出语义BuildResult见 internal/xcode/build.go是稳定、可机读的结果结构。成功构建的 JSON 包含请求的 project/workspace、scheme、显式提供的 configuration 与 destination、选定的 derived-data 路径、显式提供的 result-bundle 路径、clean 选择、请求的no_code_signing覆盖、success: true、duration_ms。Table 与 Markdown 渲染同一组稳定字段渲染函数见 internal/cli/xcode/build.go。no_code_signing只反映“请求了什么”并不声称解析了项目实际生效的签名 build setting——这是设计文档明确划定的边界。Build/Products 目录只报“新创建”不猜产物路径Build流程internal/xcode/build.go在启动 xcodebuild 前先记录{derivedDataPath}/Build/Products是否已存在构建成功且该目录由本次调用首次创建时才在结果中补充build_products_path。asc 不做两件事不猜测单个产物路径如.app的具体位置也不解析人类可读的构建日志。Xcode 日志与诊断始终走 stderr保证 stdout 上的机器可读结果保持可解析。exit_status 与错误链xcodebuild 完成后asc 会附带exit_status成功0普通进程失败子进程的实际退出码preflight 与取消类失败不携带该字段——因为此时不存在有意义的进程退出码。失败构建返回非零命令错误错误信息与错误链xcode build: ...保留底层原因。CLI 层对失败还会在 stderr 输出Error: xcode build failed with exit status N或区分context.DeadlineExceeded/context.Canceled/ 负数退出码等中断原因见 internal/cli/xcode/build.go。核心测试覆盖了子进程失败、退出状态、取消与产物目录报告见 internal/xcode/build_test.go。兼容性、失败模式与可发现性纯增量行为这是纯增量功能既有 archive/export 调用的错误文本、错误链、输出 schema 均不改变。命令形态与输出格式校验全部发生在文件系统或子进程副作用之前这意味着拼错参数时不会留下任何中间产物。显式返回的失败模式包括缺少 Xcode非 macOS 主机上会抛出既有的 Xcode 不可用错误不受支持的主机project/workspace 路径不存在或后缀类型错误缓存路径解析失败如取不到用户缓存目录构建失败携带exit_status上下文取消Ctrl-C / 超时。进程参数一律以 argv 切片传递永不经过 shell——这与 archive/export 的“无 shell 直通”模型保持一致避免注入与引号转义问题。可发现性与运行前提asc xcode build可通过以下途径发现根命令与xcode组的帮助输出、实时命令搜索、生成的命令文档以及 README/workflow 示例例如 README.md 中的 workflow 示例就使用了asc xcode build --project App.xcodeproj --scheme App --destination ... --no-code-signing --output json。执行仅限 macOS其他主机上沿用既有的 Xcode 不可用错误提示。验证计划设计文档给出了从 CLI 层到仓库门禁的完整验证矩阵对应源码中的测试布局CLI RED/GREEN 覆盖必填 flag、project/workspace 互斥、位置参数拒绝、每个类型化 flag、可重复的原始 flag、JSON/table/Markdown 渲染见 internal/cli/xcode/build_test.go核心 RED/GREEN 覆盖参数规整化、确定性默认路径、参数顺序与空格保留、clean/action 放置、显式签名行为、路径校验、不支持主机、子进程失败与退出状态、取消、产物目录报告见 internal/xcode/build_test.go构建产物检查帮助、搜索、输出流、usage 退出码仓库门禁格式、文档、lint、测试、race、构建只读源码验证对 Zenther 与第二个本地 Xcode 项目/工作区做只读验证派生数据置于每个检出目录之外并在前后做 clean-source 检查。备选方案回顾设计文档还记录了三个被否决的替代方案理解它们有助于把握命令边界文档化的裸--xcodebuild-flagbuild别名难以发现且不提供校验与结构化输出——这正是本命令存在的原因复用archive做编译检查archive 执行的是语义完全不同的工作产出.xcarchive会污染产物目录、拖慢流程对“看起来像模拟器”的 destination 自动禁用签名虽便利但会让 destination 解析变得策略敏感并可能静默改变签名行为显式、可组合的--no-code-signing标志更安全、更可预测。综上asc xcode build用“确定的参数组装 保守的默认行为 稳定的结构化输出 严格的受管参数边界”四项设计原则为模拟器/真机编译检查提供了一个可脚本化、可被 CI 安全消费的一等公民入口其行为细节均可在 internal/xcode/build.go 与 internal/cli/xcode/build.go 中逐行印证。赞分享【免费下载链接】App-Store-Connect-CLIFast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions, and more项目地址https://gitcode.com/gh_mirrors/ap/App-Store-Connect-CLI点击查看免费下载相关推荐Radix Vue PinInputRoot 组件完全指南构建高质量验证码与 OTP 输入框Radix Vue PinInputRoot 组件完全指南构建高质量验证码与 OTP 输入框 PinInputRoot 是 radix vueReka UIApp Store Connect CLI 驱动 Xcode本地 build、archive、export 与 xcode test 结构化结果完整指南App Store Connect CLI 驱动 Xcode本地 build、archive、export 与 xcode test 结构化结果完整指南 ApApp-Store-Connect-CLI 结构化 Xcode 版本编辑器asc xcode version 从逐行扫描到跨平台结构化改写App Store Connect CLI 结构化 Xcode 版本编辑器 asc xcode version 从逐行扫描到跨平台结构化改写 导读 本文围绕上一篇如何在3分钟内用OxyPlot为你的.NET应用添加专业级数据可视化下一篇Nuxt.js项目中Nginx URL重写与路由处理的深度解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考