版本管理与正式构建
两种构建
| 用途 | 在 ui/frontend 执行 | 作用 |
|---|---|---|
| 日常开发与定位 | npm run build -- mp-weixin | 不主动递增发布版本，默认开发通道 |
| 准备一次新发布版本 | npm run build:release:mp-weixin | 先递增 manifest 的 patch 与 versionCode，再构建正式包 |
正式命令有源码副作用，不用于反复调试。versionName 为三段数字，versionCode 为非负整数字符串；主次版本调整需产品版本决策。构建失败不自动撤回已递增的版本，先查 manifest 和本次产物，不连续执行命令试错。
发布准备顺序
- 固定本次源码范围和依赖锁，确认未夹带其他人的未完成改动。
- 执行对应静态门禁与业务定向测试，记录未测分支和阻断项。
- 确认
.env.local、租户、应用、小程序 AppID 和目标网关。 - 使用正式命令生成
dist/build/mp-weixin，保留命令结果与版本变化。 - 检查包体、分包与实际编译参数，绑定源码与构建标识。
当前正式脚本的约束
脚本会要求项目已登记的 HTTPS 发布接口，并在 Windows 上可能调用 env:test；旧视频服务地址也必须为 HTTPS。构建时设置 production、关闭模拟支付和页面诊断。新环境不能只在命令行覆盖一个 URL 就假定受支持，应先调整并评审发布合同。
构建成功后仍需工具加载、体验版和真机检查。只有源码版本与产物一致且发布核验完成，才进入上传流程。