看懂 VSCode 发布中心后,下一步该把 App 发版交给 CLI 了

上一篇我们把 VSCode 发布中心的几个关键区域拆开了。

这一篇解决的是另一种痛苦:

同一套 App 发版动作,你为什么还要一遍遍亲手点?

第一次理解流程可以靠界面。

但只要开始重复,你就会发现:

  • 每次都点同样的按钮
  • 每次都填同样的更新说明
  • 每次都盯同样的进度
  • 每次都担心是不是漏了平台

这时候真正该接手的,不是鼠标。

而是一条可以反复执行的命令。

VSCode 适合看懂流程,CLI 适合重复执行

当你开始经常发版、团队协作、想接入 CI/CD,命令行会更顺。

说白了:

界面适合理解流程,命令适合复用流程。

3 分钟开跑

第 1 步:安装 app-ship

app-ship 是独立上传引擎,不依赖 Flutter,也不依赖 VSCode。

bash 复制代码
npm install -g @huoye/app-ship
app-ship platforms
app-ship init

第 2 步:生成 app-ship.yaml

配置文件生成后,把平台配置收回来,别再散在文档和聊天记录里。

yaml 复制代码
publish:
  pgyer:
    enable: true
    apiKey: '${PGYER_API_KEY}'

第 3 步:密钥放进项目级环境文件

别把明文密钥写死。

bash 复制代码
PGYER_API_KEY=your-api-key
HUAWEI_CLIENT_ID=your-client-id
HUAWEI_CLIENT_SECRET=your-client-secret
HUAWEI_APP_ID=your-app-id

然后在终端里加载它:

bash 复制代码
set -a
source ./.env.local
set +a

如果你要给这一步配图,最稳的做法是直接做成左右分屏:

  1. 左边打开 app-ship.yaml,把 ${VAR_NAME} 引用露出来
  2. 右边打开终端,展示 source ./.env.local 或 set -a 这类加载命令
  3. 画面底部加一句短标语:密钥不要进仓库
  4. 统一用亮色主题,字体放大到手机上也看得清

第 4 步:本地先跑通一次

bash 复制代码
app-ship upload -c app-ship.yaml -f ./app-release.apk --platform pgyer,huawei --changelog "修复已知问题"

关键不是命令短。

而是以后每次发版,不用再把同一套动作重新点一遍。

第 5 步:把同一条命令接进 CI/CD

本地跑通后,几乎可以原样搬进流水线:

yaml 复制代码
- run: npm install -g @huoye/app-ship
- run: app-ship upload -c app-ship.yaml -f ./app-release.apk --platform pgyer,huawei --changelog "CI Build"

常用命令速查

场景 命令
查看平台 app-ship platforms
按配置上传 app-ship upload -c app-ship.yaml -f ./app-release.apk
指定平台 app-ship upload -c app-ship.yaml -f ./app-release.apk --platform pgyer,huawei
调试日志 app-ship upload -c app-ship.yaml -f ./app-release.apk --platform pgyer --verbose

CI/CD 先别一口吃成胖子:本地单平台、本地多平台、CI 单平台、CI 多平台,一步步来。

怎么算跑通

满足这几条,就算命令链路跑通了:

  • 本机能执行 app-ship upload
  • 至少一个目标平台返回可用结果
  • app-ship.yaml 已改成环境变量引用
  • 同一条命令能搬进 CI/CD

CLI 真正值钱的地方,不是更极客。

而是把一次能跑通的事,变成每次都能复用的事。

如果你也做 App 发版,你更想先把哪一步从"手点"改成"命令"?

是本地上传、打 tag 自动发版,还是按平台拆分触发?

留言告诉我,我后面把最痛的那一步继续拆开写。

相关推荐
冬奇Lab6 小时前
一天一个开源项目(第263篇):江山时序 —— 纯静态的中国历史交互地图,从三家分晋拖到今天,还能让 AI 查地名
开源
wflynn7 小时前
GitHub 日榜趋势速报 | 2026-11-18
开源·github
Pniubi10 小时前
SoduWork开源贡献日记——开源贡献入门教程
开源
Yeautumn11 小时前
给 Antigravity 搓了个「主 Carbon + 副 Neon」混合编排插件:让顶配模型当包工头,快手模型并发干活
开源
阿里云云原生14 小时前
云原生开源项目周报(2026 / 11.09 — 11.16)
云原生·开源
Bigger17 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
openUBMC17 小时前
从带外管理到开源共建:openUBMC 走进华南高校
开源
茶底世界之下17 小时前
雨后的黄电车:用 Awaking 给灰色街景定一个主角
ios·app·产品
wflynn19 小时前
GitHub 今日推荐|rust-anything:录制真实输入输出,渐进式重写热点函数到 Rust
rust·开源·github·cli·claude-code·agent-skills
wflynn20 小时前
GitHub 日榜趋势速报 | 2026-11-17
开源·github