AppCenter CLI

一条命令，把版本送到平台

CLI 把「建版本 + 传产物」合成一次调用。构建完直接上传，不用在后台点四次；平台会自动从 APK 读取包名与版本号，也能按扩展名判断平台。

Windowsappcenter-win-x64.exex64 · 单文件 · 无需安装 .NET Linuxappcenter-linux-x64x64 · 单文件 · 下载后 chmod +x

1. 配置发布凭证

在管理后台「发布凭证」页创建，密钥只放在环境变量里：

# Windows
$env:APPCENTER_API_KEY = "<凭证>"

# Linux / macOS
export APPCENTER_API_KEY="<凭证>"

2. 写一份 .appcenter.json（可选）

放在仓库根目录即可提交。写清项目与应用别名后，命令里就不用再传标识和平台；只有一个应用时连 --app 都能省。

{
  "project": "smart-travel",
  "apps": {
    "android": {
      "platform": "Android",
      "identifier": "com.justwei.travel.demo",
      "artifact": "app/build/outputs/apk/release/*.apk"
    }
  }
}

该文件禁止出现任何密钥字段（CLI 发现会直接报错退出）。产物路径支持 glob，但必须恰好命中一个文件。

3. 预检，然后上传

# 预检：鉴权、项目/应用归属、版本状态、文件大小、SHA256 全部校验，但不落库不落盘
appcenter upload --app android --dry-run

# 正式上传（更新说明取最近一个 tag 之后的提交）
appcenter upload --app android --changelog-from-git

APK 可以完全不传 --version / --code / --identifier，平台会从包里读出来。Windows 安装包则自动取文件版本资源里的版本号。

常用命令

命令	作用
`upload`	建 / 更新草稿版本并上传产物
`apps`	列出凭证可见的项目与应用，用来抄标识
`release list`	查询版本状态，确认「发没发出去」
`config init`	生成 `.appcenter.json` 模板

退出码（供 CI 分支）

码	含义
`0`	成功（含预检通过）
`2`	用法 / 配置错误
`3`	鉴权失败（凭证缺失、无效、过期）
`4`	业务拒绝（项目/应用不存在、版本已发布不能覆盖）
`5`	传输 / 校验失败（网络、超时、SHA256 不一致）