用途:把已有 iOS .xcarchive 或 IPA 转为仅限已注册设备安装的私有分发链接,适用于不走 TestFlight 或 App Store 的临时发布测试。
主要能力:提供 plan→apply→resume/status→verify 的端到端流程,以及 inspect→prepare→publish 的底层 IPA 流程。plan 只读,可能返回 ready:false;apply 可注册缺失设备、创建 App ID 与后继 ad hoc 描述文件、写入本地产物并发布不可变对象;status 仅本地,resume 会重新校验证据,verify 执行实时抓取。
使用方式:先确认命令契约,如 asc distribute --help、asc distribute plan --help 等。创建私有分发 spec 与 devices.json,设置 owner-only 权限,例如 chmod 600。规划命令:asc distribute plan --archive-path ".asc/artifacts/App.xcarchive" --config ".asc/distribution/config.json" --plan ".asc/distribution/plan.json" --state-dir ".asc/distribution/runs" --output json。经用户授权完整 planHash 后执行 apply,再按 runId 使用 status、resume、verify。
限制:需要已有 .xcarchive(单一主 App target,含扩展、Watch App、App Clip 时 v1 不 ready)、PKCS#12 身份、受保护 devices 文件、App Store Connect 权限及已有 S3 兼容桶。不创建桶、不改策略、不删除旧构建、不安装或启动 App。凭据不得写入 spec、日志或聊天,应使用 ASC_S3_ACCESS_KEY_ID 等环境变量。输入漂移、对象冲突、签名过期或链接过期需重新规划。安装链接属 bearer 凭据,仅通过私有渠道分享。具体收费与平台支持暂未提供。