跳到正文
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