ASC Release Flow

🚀 一键发布至 TestFlight 与 App Store

一站式 iOS 应用发布工作流,支持 TestFlight 分发与 App Store 提审,通过 CLI 实现构建上传、版本管理与自动提交。

收藏
10.2k
安装
2.5k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

asc-release-flow 提供从构建上传到最终上架的完整发布流水线,基于 asc CLI 工具封装了苹果 App Store Connect API 的复杂操作。

主要场景:

  • TestFlight 快速分发asc publish testflight --app <APP_ID> --ipa <PATH> --group <GROUP_ID> 单命令完成上传并自动分发给指定测试组
  • App Store 正式提审asc publish appstore --app <APP_ID> --ipa <PATH> --version <VERSION> 支持附加 --submit --confirm 自动提交审核

细粒度控制:当需要分步操作时,提供完整的手动序列——先 asc builds upload 上传构建,通过 asc builds latest 获取构建 ID,再按需执行 add-groups 分发或 attach-build + submit create 完成上架流程。

显著优点

1. 端到端自动化:将传统需要 Xcode Organizer + App Store Connect 网页的多步操作压缩为单条命令,CI/CD 集成友好
2. 灵活的分发策略:支持同时指定多个测试组 (GROUP1,GROUP2),可选 --notify 自动通知测试员

3. 状态可观测--wait 参数支持轮询等待处理完成,--output table/markdown 提供人类可读的进度反馈

4. 幂等性设计:要求每次上传使用新构建号,避免版本冲突

潜在局限

1. 认证依赖前置:必须预配置 asc auth loginASC_* 环境变量,首次使用门槛较高
2. 平台限定:仅支持苹果生态(iOS/macOS/tvOS/watchOS),无法跨平台复用

3. 审核黑箱submit 后仍受苹果审核队列和人工审核政策影响,无法保证上架时效

4. 版本管理复杂attach-build 需要手动关联 version-idbuild,对 App Store Connect 数据模型不熟悉易出错

适合人群

  • iOS CI/CD 工程师:需要自动化构建-上传-分发流水线
  • 移动开发团队:频繁进行 TestFlight 内测或灰度发布
  • DevOps 工程师:将应用发布集成到 GitHub Actions / GitLab CI / Jenkins 等企业工作流

常规风险

  • 构建号冲突:若未递增 CFBundleVersion,上传将失败或覆盖(如启用替换)
  • 权限泄露ASC_API_KEY 等凭证需妥善保管,避免硬编码在仓库
  • 审核拒回:自动提交后若元数据不合规(截图、描述、权限说明),可能导致账号警告或封禁
  • 网络超时:大体积 IPA 上传可能触发 --timeout,需配合 --poll-interval 合理调整重试策略

ASC Release Flow 内容

手动下载zip · 2.0 kB
skill-card.mdtext/markdown
请选择文件