Plugin Light

Appearance

作者

novlan1

2025.9.3

小程序发布指南 ​

这里说的小程序“发布”指的是通过 miniprogram-cli 进行上传和预览。

1. 研发平台 ​

先简单介绍下前端研发平台，平台地址为：https://mobile.aow.com/rd-platform-web/

主要包含CI/CD、公共组件管理、白名单管理、域名管理、COS管理等功能。

工程架构上，主要分为两级：

  • 主工程。每个 Git 仓库为一个主工程
  • 子工程。主工程下可以有多个子工程，可以看作定制化的 monorepo
- main-project
 - src
  - project
    - sub-project

2. 小程序 CI 设计思想 ​

分支和流水线

  1. 子工程的不同分支，会对应不同的机器人，以及独立的流水线
  2. 只有 release 分支可以发布正式环境，其他分支只能发布测试环境
  3. 可以接入 debug-popup 组件 进行后台环境的动态切换

配置

  1. 研发平台配置只是中间层，所有信息都存储在七彩石
  2. 七彩石配置地址

机器人

  1. 由于微信侧限制，机器人范围只能为1-30
  2. 一般业务同时在测的需求应该不会超过28个，基本满足需求

对比 H5 发布

维度

H5小程序说明
流水线一个工程共用一条流水线不同子工程的不同分支，都独立一条流水线空间换时间，构建速度更快
发布本质资源上传到COS或集群资源上传到微信后台小程序需额外提审和发布

3. 小程序接入 ​

新的小程序接入可以按照以下步骤操作。

  1. 点击工程“详情”，会看到子工程列表
  1. 点击子工程名称，进入子工程详情页面
  1. 切换到“小程序CI”页签，点击“立即接入”
  1. 填写基本信息，点击确定进行提交
  1. 回到子工程下“小程序CI”页签，点击"新增发布"
  1. 填写机器人、分支、环境等信息

4. 新分支接入 ​

微信限制CI机器人最多为30个。

4.1. 新增机器人 ​

在当前项目接入分支数小于30个时，可以点击“新增发布”，新增分支即可。

配置完成后，会生成一条唯一的流水线，并设置了当前工程、子工程、分支、机器人、发布环境等信息。

4.2. 修改之前机器人 ​

如果当前子工程接入分支数已经有30个了，可以修改已经不用的分支。

5. 小程序发布 ​

可以在“小程序CI”页签下点击“微信小程序构建”，或者“QQ小程序构建”进行构建。

构建正式环境需要填写发布原因。

⚠️ 注意，如果要真正发布小程序的话，还要在微信开发者后台进行提审操作。

6. 发布通知 ​

发布完成后，会在CI群内有对应的通知。

通知不仅有本次发布的基本信息，还有包体积统计、二维码信息。

接入分发插件的小程序，还有引用错误监控。