SuperAPI AI 工具集

asc-notarization

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:为在 App Store 之外分发 macOS 应用执行签名、打包与公证流程,结合 xcodebuild 与 asc CLI。

前置条件:已安装 Xcode 并配置命令行工具;已配置认证(asc auth login 或 ASC_* 环境变量);本地钥匙串中有 Developer ID Application 证书;应用的 Xcode 项目可为 macOS 构建。

主要步骤与能力:

  1. 预检签名身份:security find-identity -v -p codesigning | grep "Developer ID Application"。若缺失,需在 Apple 开发者证书页面创建(App Store Connect API 不支持创建 Developer ID 证书)。
  2. 归档:xcodebuild archive -scheme "YourMacScheme" -configuration Release -archivePath /tmp/YourApp.xcarchive -destination "generic/platform=macOS"。
  3. 用 Developer ID 导出:创建 method 为 developer-id、signingStyle 为 automatic 且含 teamID 的 ExportOptions plist,再执行 xcodebuild -exportArchive。
  4. 验证导出:codesign --verify --deep --strict --verbose=2 与 codesign --display --verbose=4,确认 Authority 链、TeamIdentifier 与时间戳;验证失败或身份异常时应停止打包上传并重新导出。
  5. 制作 ZIP:ditto -c -k --keepParent。
  6. 提交公证:asc notarization submit --file,可加 --wait,或用 --poll-interval 30s --timeout 1h 自定义轮询。
  7. 查看结果:asc notarization status --id、asc notarization log --id、asc notarization list。
  8. 可选装订票据:xcrun stapler staple;DMG 需先 hdiutil create 创建容器再装订。

支持格式:.zip(最简单)、.dmg(拖放安装)、.pkg(安装包,需 Developer ID Installer 证书)。PKG 需用 productsign 签名后提交。

限制与排错:asc notarization 使用 Apple Notary API v2,而非 xcrun notarytool;认证共用其他 asc 命令的 API key;上传直传 Apple S3 并流式处理,超 5 GB 自动分片。大文件可设 ASC_UPLOAD_TIMEOUT=5m。常见错误包括无有效 Developer ID 证书、缺少安全时间戳、嵌套二进制未签名、缺 hardened runtime 等,可通过 log 获取详情。切勿在验证时添加 --sign 或 --force;修改信任设置需明确授权。具体收费、价格等资料暂未提供。