跳到正文
asc-cli 技能手册

asc-notarization

macOS 公证

使用 Developer ID 签名完成 macOS 应用的归档、导出与公证。

覆盖 App Store 之外分发 macOS 应用所需的完整链路:归档 → Developer ID 导出 → 压缩 → 提交公证(asc notarization)→ 装订(可选,使用 xcrun stapler),并帮助排查 Developer ID 签名或信任链问题。

适用场景

  • 需要为 App Store 之外的分发对 macOS 应用做公证时
  • 想走完整流程:归档 → Developer ID 导出 → 压缩 → 公证 →(可选)装订时
  • 排查 Developer ID 签名或信任链问题时

命令示例

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

zsh
# 归档并以 Developer ID 方式导出(交给智能体执行 xcodebuild)
对智能体说归档我的 macOS 应用,以 Developer ID 方式导出并压缩为 zip
# 提交公证并等待结果;失败时查看开发者日志
$asc notarization submit --file "./YourApp.zip" --wait
$asc notarization log --id "SUBMISSION_ID"
# 公证通过后装订票据(Apple 自带工具,非 asc 命令)
$xcrun stapler staple "./YourApp.app"

安装此技能

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

zsh
$asc install-skills