docs: 更新README文档,补充鸿蒙小程序发布流程

1.  给原有章节标题增加了多余的井号修正为正确层级
2.  新增鸿蒙小程序发布完整流程章节
3.  更新版本特性和构建脚本说明,新增极限压缩优化、harmony.patch.js等内容
This commit is contained in:
2026-05-27 18:15:55 +08:00
parent 6837a5d934
commit 7c703ace4f

View File

@@ -29,14 +29,14 @@
#### 4.1.1 基本操作步骤(通用版/定制化版)
##### 4.1.1.1 【前置准备】
##### ##### ##### ##### 【前置准备】
1. 在项目根目录打开终端安装依赖:
```bash
npm install
```
*已有依赖可跳过此步骤*
##### 4.1.1.2 【发布构建】
##### ##### ##### ##### 【发布构建】
1. 使用 HBuilderX 打开项目(不用改manifest.json的web,只有H5要改 )
2. 选择菜单栏「发行」 → 「小程序-微信」→ 「发行」,等待构建完成
⚠️ **注意**:底部控制台弹出"请在微信小程序开发者工具中点击上传"后再执行下一步
@@ -46,18 +46,18 @@
*压缩包文件名末尾为 Git 提交 ID*
*同时该目录下会生成未压缩的 `mp-weixin` 目录*
##### 4.1.1.3 【验证与重命名】
##### ##### ##### ##### 【验证与重命名】
1. 打开未压缩的 `mp-weixin` 目录,找到 `site.js` 文件,将文件内的 `uniacid` 值改为当前客户编号(如:2812)并保存
2. 打开微信开发者工具,导入「mp-weixin」目录,点击「编译」,在开发者工具控制台验证有无报错,以及能否返回对应客户的业务数据
3. 确保无误后将生成的 mp-weixin 压缩包重命名
- **定制化版**格式:`定制化-客户编号-域名-mp-weixin-当前日期-Git提交ID.zip`
- **通用版**无需重命名
💡 **示例**:`custom-2812-xcx.aigc-quickapp.com-mp-weixin-2026-05-11-3bff91e.zip`
🚫 **禁止**:压缩包命名禁止包含 `/ \ : * ? " < > |` 等特殊字符
##### 4.1.1.4 【交付与最终发布】🔍
##### ##### ##### ##### 【交付与最终发布】🔍
1. 将重命名后的文件发送给技术人员
*📌通用版直接将生成的 mp-weixin 压缩包发送给技术人员*
2. **技术人员操作流程**:
@@ -65,7 +65,23 @@
- 确认 `site.js` 中的 `uniacid` 为客户编号
- 用微信开发者工具导入解压后的代码目录
- 编译验证无误后,上传发布
##### 4.1.1.5 【本地设置】
#### 4.1.2 鸿蒙小程序发布(mp-harmony)
##### ##### ##### ##### 【发布构建】
1. 使用 HBuilderX 打开项目
2. 选择菜单栏「发行」 → 「HarmonyOS」→ 「发行」,等待构建完成
3. 构建完成后,**自动执行** `harmony.patch.js` 补丁脚本(配置拷贝 + ZIP 打包)
4. 找到项目根目录 `/unpackage/dist/build` 下生成的 mp-harmony 压缩包
##### ##### ##### ##### 【交付与最终发布】🔍
1. 将生成的 `.zip` 文件发送给运维人员
2. **运维人员操作流程**:
- 解压压缩包
- 打开鸿蒙开发者工具,导入解压后的代码目录
- 验证代码无报错后,执行上传发布操作
##### ##### ##### ##### 【本地设置】
![](readme_files/1.jpg)
#####
---
@@ -116,6 +132,7 @@ H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
|------|---------|------|
| `__app_version` 全局变量注入 | 所有平台 | 构建产物的 `vendor.js`(小程序)或 `index.html`(H5)中自动内联版本数据 |
| 构建版本信息查看 | 所有平台 | 首页右下角连击 5 次弹出模态框显示 `commitId` 和 `buildTime` |
| 极限压缩优化 | 小程序(mp-weixin / mp-harmony) | 生产构建自动应用多层次压缩配置,显著减小产物包体积 |
版本数据包含:
- **commitId**:当前构建的 Git 短提交 ID
@@ -136,7 +153,11 @@ H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
💡 **示例 ZIP**:`xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip`
**微信小程序**生产构建时自动执行:
- 拷贝 `site.js` / `project.config.json` / `project.private.config.json` 到构建目录
- 拷贝 `site.js` / `project.config.json` / `project.private.config.json` 文件到构建目录
- 创建 ZIP 包(文件名包含 Git 提交 ID)
**鸿蒙小程序**生产构建时自动执行:
- 拷贝必要配置文件到构建目录
- 创建 ZIP 包(文件名包含 Git 提交 ID)
### 5.3 环境配置
@@ -165,6 +186,9 @@ H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
- `VersionInjectPlugin`:webpack emit 钩子自动注入 `__app_version` 到所有平台产物
- 首页右下角连击 5 次显示构建版本信息(commitId + buildTime)
- `mp-weixin.patch.js` 精简为仅文件拷贝和 ZIP 打包
- 新增 `harmony.patch.js`:鸿蒙小程序生产构建补丁脚本(配置拷贝 + ZIP 打包)
- `open-directory.js`:构建完成后自动打开输出目录
- 极限压缩优化:集成 `zion-uniapp-mp-load-package` 插件 + TerserWebpackPlugin 多层次压缩配置
- 修复 `openWxWorkServiceChat` 方法中 fail 回调语法错误
- ZIP 文件名末尾使用 Git 提交 ID 替换时间戳
- 构建脚本幂等性修复,支持多次运行不产生重复注入