跳到正文
asc-cli 技能手册

asc-xcode-build

Xcode 构建与导出

编译、归档、生成导出选项并导出 IPA / PKG,上传前的最后一步。

覆盖从本地 Xcode 项目到可上传产物的全过程:构建、归档(archive)、生成并自定义 ExportOptions.plist、导出 IPA 或 PKG,并能管理版本号与构建号(asc xcode version)、衔接 asc builds upload / asc publish 完成上传,以及排查常见的导出签名与构建号问题。

适用场景

  • 需要生成可上传的 IPA 或 PKG 时
  • 在搭建 CI/CD 构建流水线时
  • 需要生成或自定义 ExportOptions.plist 时
  • 需要面向已注册设备的现代 release-testing 导出时
  • 排查导出时「No profiles for bundle ID」、CFBundleVersion 过低、macOS 缺少图标导致构建被拒等问题时

命令示例

大写占位符(如 APP_ID、BUILD_ID)请替换为你自己的值;标有「对智能体说」的行是给 AI 智能体的提示词,不会被复制。

zsh
# 自动取下一个可用构建号,再归档并导出(具体参数请用 asc xcode archive --help 查看)
$asc xcode version edit --next-build-number --app "APP_ID" --platform IOS
对智能体说归档并导出我的 iOS 应用为 IPA,以便上传到 App Store Connect
# 导出后上传,或直接发布到 TestFlight
$asc builds upload --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --wait
$asc publish testflight --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --group "GROUP_ID" --wait

安装此技能

安装 asc 后运行下面的命令即可一次性安装全部技能,其中包含 asc-xcode-build。

zsh
$asc install-skills