asctl

管理 App Store Connect 应用元数据的命令行工具。

从 App Store Connect 下载应用的描述、关键字、推广文本等元数据到本地纯文本文件，方便编辑和版本控制；发布时将本地元数据同步到新版本。

功能

• init — 从 App Store Connect 最新版本下载元数据，按平台和语言保存到本地目录
• release — 创建新版本或更新已有版本，将本地元数据同步到 App Store Connect
• upload — 使用 Build Upload API 上传 .ipa / .pkg 构建文件到 App Store Connect
• latest-build — 查询指定平台最新的 App Store Connect build 号
• reviews — 查询 App Store 用户评论，并创建或更新开发者回复

安装

go install github.com/rainbend/appstoreconnect-cli@latest

或从源码构建：

git clone https://github.com/rainbend/appstoreconnect-cli.git
cd appstoreconnect-cli
make build    # 输出到 bin/asctl
make install  # 安装到 $GOPATH/bin/asctl

前置准备

需要一个 App Store Connect API 密钥（.p8 文件）。参考 创建 API 密钥 获取以下信息：

• Key ID — API 密钥 ID
• Issuer ID — 颁发者 ID
• Private Key — 下载的 .p8 私钥文件路径

认证参数可通过命令行 flag、环境变量或项目根目录的 .env 文件提供：

Flag	环境变量	说明
--key-id	ASC_KEY_ID	API Key ID
--issuer-id	ASC_ISSUER_ID	Issuer ID
--private-key	ASC_PRIVATE_KEY	.p8 私钥文件路径（默认 ~/.config/appstoreconnect/AuthKey_{KEY_ID}.p8）

使用

初始化元数据

从 App Store Connect 下载最新版本的所有本地化元数据到本地：

asctl init --app-id <APP_ID> --platform ios

执行后会在 .metadata/ 目录下生成如下结构：

.metadata/
└── ios/
    ├── en-US/
    │   ├── description.txt
    │   ├── keywords.txt
    │   ├── promotional_text.txt
    │   └── whats_new.txt
    └── zh-Hans/
        ├── description.txt
        ├── keywords.txt
        ├── promotional_text.txt
        └── whats_new.txt

每个字段对应一个纯文本文件，直接编辑即可。

发布版本

将本地元数据同步到 App Store Connect，如果版本不存在会自动创建：

asctl release --app-id <APP_ID> --version 1.2.0 --platform ios

使用 --whats-new 一次性为所有语言设置更新说明：

asctl release --app-id <APP_ID> --version 1.2.0 --whats-new "Bug fixes and improvements"

如果不指定 --whats-new，则从各语言目录下的 whats_new.txt 读取。

上传构建

使用 App Store Connect Build Upload API 上传构建文件：

asctl upload --app-id <APP_ID> --platform ios --file ./build/MyApp.ipa

.ipa 文件会自动从 Payload/*.app/Info.plist 读取版本号和 build 号；如果需要覆盖，可以显式传入：

asctl upload \
  --app-id <APP_ID> \
  --platform ios \
  --file ./build/MyApp.ipa \
  --version 1.2.0 \
  --build 42

上传 macOS .pkg 时需要显式提供版本号和 build 号：

asctl upload --app-id <APP_ID> --platform macos --file ./build/MyApp.pkg --version 1.2.0 --build 42

如需等待 App Store Connect 完成上传处理：

asctl upload --app-id <APP_ID> --file ./build/MyApp.ipa --wait

查询最新 build 号

查询指定平台最新上传的 App Store Connect build 号：

asctl latest-build --app-id <APP_ID> --platform ios

默认只输出 build 号，方便在脚本中使用。需要更多信息时：

asctl latest-build --app-id <APP_ID> --platform ios --details

只查询某种处理状态的 build：

asctl latest-build --app-id <APP_ID> --platform ios --state valid

查询和回复用户评论

查询最近的 App Store 用户评论：

asctl reviews list --app-id <APP_ID>

按地区、评分和已发布回复状态过滤：

asctl reviews list \
  --app-id <APP_ID> \
  --territory USA,CHN \
  --rating 1,2 \
  --response-state unresponded

查看已有回复内容：

asctl reviews list --app-id <APP_ID> --response-state responded --include-response

查询最近一周的评论：

asctl reviews list --app-id <APP_ID> --days 7

或指定起始日期：

asctl reviews list --app-id <APP_ID> --since 2026-06-01

回复一条评论；如果这条评论已经有回复，Apple 会替换为新的回复内容：

asctl reviews reply --review-id <REVIEW_ID> --body "感谢反馈，我们会继续改进。"

也可以从文件或标准输入读取回复内容：

asctl reviews reply --review-id <REVIEW_ID> --file reply.txt
cat reply.txt | asctl reviews reply --review-id <REVIEW_ID> --file -

参数说明

全局参数

参数	环境变量	说明
--key-id	ASC_KEY_ID	API Key ID（必填）
--issuer-id	ASC_ISSUER_ID	Issuer ID（必填）
--private-key	ASC_PRIVATE_KEY	.p8 私钥文件路径（默认 ~/.config/appstoreconnect/AuthKey_{KEY_ID}.p8）

init 命令

参数	简写	默认值	说明
--app-id	-a	ASC_APP_ID	App Store Connect App ID（必填）
--platform	-p	ios	平台：ios 或 macos

release 命令

参数	简写	默认值	说明
--app-id	-a	ASC_APP_ID	App Store Connect App ID（必填）
--version	-v	—	版本号，如 1.2.0（必填）
--platform	-p	ios	平台：ios 或 macos
--whats-new	—	—	更新说明，覆盖所有语言的 whats_new.txt

upload 命令

参数	简写	默认值	说明
--app-id	-a	ASC_APP_ID	App Store Connect App ID（必填）
--platform	-p	ios	平台：ios 或 macos
--file	-f	—	构建文件路径，支持 .ipa / .pkg（必填）
--version	-v	—	版本号，.ipa 可自动读取
--build	-b	—	build 号，.ipa 可自动读取
--uti	—	按扩展名推断	构建文件 UTI 覆盖值
--wait	—	false	等待 App Store Connect 完成上传处理
--wait-timeout	—	30m	--wait 的最长等待时间

latest-build 命令

参数	简写	默认值	说明
--app-id	-a	ASC_APP_ID	App Store Connect App ID（必填）
--platform	-p	ios	平台：ios 或 macos
--state	—	all	处理状态：all、valid、processing、failed、invalid
--details	—	false	输出 build ID、处理状态、上传时间等详细信息

reviews list 命令

参数	简写	默认值	说明
--app-id	-a	ASC_APP_ID	App Store Connect App ID（必填）
--territory	—	—	地区过滤，多个地区用逗号分隔，如 USA,CHN,HKG
--rating	—	—	评分过滤，多个评分用逗号分隔，如 1,2,5
--response-state	—	all	已发布回复过滤：all、responded、unresponded
--since	—	—	只返回指定时间之后创建的评论，支持 YYYY-MM-DD 或 RFC3339
--days	—	0	只返回最近 N 天的评论，如 7 表示最近一周
--sort	—	-createdDate	排序：createdDate、-createdDate、rating、-rating
--limit	—	20	最多返回的评论数量
--include-response	—	false	同时输出已有回复内容和状态
--json	—	false	输出 JSON

reviews reply 命令

参数	简写	默认值	说明
--review-id	—	—	要回复的 customer review ID（必填）
--body	—	—	回复文本
--file	—	—	从文件读取回复文本，传 - 表示从标准输入读取
--json	—	false	输出 JSON

典型工作流

# 1. 设置环境变量（或创建 .env 文件）
export ASC_KEY_ID="your-key-id"
export ASC_ISSUER_ID="your-issuer-id"
export ASC_PRIVATE_KEY="/path/to/AuthKey.p8"
export ASC_APP_ID="123456789"

# 2. 首次初始化，拉取现有元数据
asctl init

# 3. 编辑本地元数据文件
vim .metadata/ios/en-US/description.txt

# 4. 发布新版本
asctl release --version 2.0.0 --whats-new "全新设计"

License

MIT