Repolode
rorkai

rorkai/App-Store-Connect-CLI

面向 App Store Connect API 的命令行工具,用于在终端或 CI 中自动化 iOS、macOS 等平台的发布流程。

Star
7,979
Fork
681
未关闭 Issue
5
最近提交
18小时前

这是什么?

asc 是 Apple App Store Connect API 的命令行客户端,开发者可以用脚本完成上传构建、管理 TestFlight 测试组与反馈、提交审核、更新元数据和截图、查询审核状态等发布任务,既可在终端中运行,也能接入 IDE 或 CI/CD 流水线。

除 App Store Connect 本身的操作外,该工具还覆盖代码签名(获取证书与描述文件,并通过加密存储同步签名身份)、本地 Xcode 编译与归档辅助命令,以及 Xcode Cloud 构建运行管理。此外还提供订阅、数据分析、StoreKit 服务端 API 以及 Apple Ads 广告活动相关命令。

输出格式在交互式终端默认为表格,在管道或 CI 中默认为 JSON,也可通过参数指定表格、JSON 或 Markdown。认证使用 App Store Connect API 密钥,可保存在 macOS 钥匙串中,也可写入配置文件以适配无界面环境。项目使用 Go 编写,支持 Homebrew 和安装脚本安装,与 Apple 无关联。

核心功能

  • 01上传构建版本,管理 TestFlight 测试组、反馈与崩溃日志
  • 02提交应用审核,查看审核状态与阻塞项
  • 03从本地文件管理元数据、多语言内容和截图
  • 04获取并同步代码签名证书与描述文件
  • 05通过原始 API 命令直接调用任意 App Store Connect 接口
  • 06支持表格、JSON、Markdown 输出,CI 中默认输出 JSON

适用场景

  • 在 CI 中上传 iOS 或 macOS 构建并分发到 TestFlight
  • 编写脚本完成版本号更新、元数据同步并提交审核
  • 将崩溃日志和测试者反馈拉取到终端或看板中
  • 按语言和设备尺寸自动上传应用截图

快速上手

  1. 1

    使用 Homebrew 安装

    brew install asc
  2. 2

    确认二进制文件可以运行

    asc version
  3. 3

    使用 App Store Connect API 密钥进行身份验证

    asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network
  4. 4

    列出你的应用

    asc apps list --output table

使用前须知

  • 需要你的 Apple 开发者账户中的 App Store Connect API 密钥才能正常使用。
  • 使用 Go 1.27 构建的版本需要 macOS 13 Ventura 或更高版本。
  • 默认启用匿名的命令级使用遥测,如不需要需手动关闭。

标签

常见问题

App-Store-Connect-CLI 是什么?
面向 App Store Connect API 的命令行工具,用于在终端或 CI 中自动化 iOS、macOS 等平台的发布流程。 asc 是 Apple App Store Connect API 的命令行客户端,开发者可以用脚本完成上传构建、管理 TestFlight 测试组与反馈、提交审核、更新元数据和截图、查询审核状态等发布任务,既可在终端中运行,也能接入 IDE 或 CI/CD 流水线。
App-Store-Connect-CLI 可以免费使用吗?用的什么许可证?
App-Store-Connect-CLI 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
App-Store-Connect-CLI 还在维护吗?
活跃维护中。App-Store-Connect-CLI 最近一次提交是在 2026年10月19日。
App-Store-Connect-CLI 适合用来做什么?
在 CI 中上传 iOS 或 macOS 构建并分发到 TestFlight 编写脚本完成版本号更新、元数据同步并提交审核 将崩溃日志和测试者反馈拉取到终端或看板中 按语言和设备尺寸自动上传应用截图
App-Store-Connect-CLI 怎么安装和运行?
使用 Homebrew 安装: brew install asc 确认二进制文件可以运行: asc version 使用 App Store Connect API 密钥进行身份验证: asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network 列出你的应用: asc apps list --output table
在哪里获取 App-Store-Connect-CLI?
源代码和安装说明在 GitHub 上:https://github.com/rorkai/App-Store-Connect-CLI

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目