HBuilderX 插件 · uniApp 发行联动

打包完成,一次点按完成多市场上架

在 HBuilderX 里点「发行 → 上传应用到市场…」,插件把云打包产出的安装包上传到已开通的市场,并提交审核。不用导出、下载、再逐个登录市场后台。

基于 HBuilderX 扩展机制(2.7+ 起开放) Vue 2 / Vue 3 项目通用 不侵入项目代码
为什么用它

把「打包—上传—送审」串成一步

uniApp 项目的产物分散在打包结果的临时目录里,过去需要手动找到 APK、打开各市场后台、逐个填写版本信息。插件直接接管这一步:读取项目配置,调用平台的上传通道,把结果回传到控制台任务中心。

  • 复用控制台里已配置的凭证,不需要在本地保存密钥
  • 版本号、更新说明从项目配置读取,避免手工填错
  • 打包失败、上传失败都在 HBuilderX 控制台直接可见
HBuilderX · 发行流程
云打包 · App 资源包完成
生成 APK · v3.2.1完成
插件上传至 3 个市场进行中
回传结果到任务中心待推送

三步接入

不需要改动页面代码,项目侧只加一段非敏感配置,凭据存在 IDE 或环境变量里。

在 HBuilderX 安装插件

打开「工具 → 插件安装」,搜索 AppLaunch 发布插件并安装,重启后生效。

填入 Access Token

在控制台「工具箱」生成 Token,填入 HBuilderX 设置里的插件配置(CI 场景用环境变量)。Token 不进项目文件,manifest.json 只写应用与市场选择。

发行后一键上传

「发行 → 原生 App 云打包」完成后,从发行菜单点「上传应用到市场…」,进度在控制台任务中心同步显示。

配置示例

项目里只新增一段非敏感配置;Token 存在 IDE 配置中,不进仓库、不进云打包上传集。

manifest.json(进版本库 · 无凭据)
{
  // 其他原有配置保持不变
  "applaunch": {
    "appId": 8,
    "markets": ["huawei", "xiaomi", "oppo"],
    "autoSubmit": true,
    "tokenSource": "hbx"
  }
}
HBuilderX 设置 · 插件配置(不进版本库)
{
  "applaunch.token": "apl_********",
  // 或 CI 环境改用环境变量:
  // APPLAUNCH_TOKEN=apl_...
  "applaunch.server": "https://your-domain"
}
发行日志
[applaunch] 读取项目配置…
[applaunch] 云打包完成: app-release.apk
[applaunch] 合规检测 通过 7/7
[applaunch] 上传 → 华为应用市场 成功
[applaunch] 上传 → 小米应用商店 成功
[applaunch] 上传 → OPPO 软件商店 成功
[applaunch] 已提交审核,任务号 #20481

插件能力

围绕 uniApp 的打包流程设计,尽量少配置、少切换。

发行完一键上传

云打包产出 APK 后,从发行菜单一键上传到已开通的市场,不用再手动找安装包、登录各市场后台。

多市场勾选

在配置里列出市场标识,插件按勾选并行分发,可随时增删。

凭据与市场密钥分离

各市场密钥由服务端加密托管,绝不下发到本地;插件凭据只存 IDE 配置或环境变量,不写进项目文件、不随云打包上传、不进版本库。

进度与结果回传

上传进度、审核状态变化同步到控制台任务中心,团队其他成员也能看到。

发布前合规检测

已开通合规检测的应用,上传前自动跑一次检测,未通过时中断上传并提示缺失项。

同一套接口,可接 CI

插件走的是一套标准客户端接口,命令行与 CI 复用同一份配置(接口已规划,命令行入口随后提供)。

开发规划

插件尚在开发中,以下为计划交付顺序;实际版本与时间以发布时为准。

阶段计划交付状态
v1.0发行菜单一键上传,支持华为 / 小米 / OPPO / 荣耀,进度与审核状态回传开发中
v1.1大体积安装包分块上传、发布前合规检测联动规划中
v1.2命令行与 CI 入口,复用同一份配置规划中

把下个版本交给流水线

安装插件只需要一次,之后每次发行都省掉手工上传。