docs: 更新README文档,补充鸿蒙小程序发布流程
1. 给原有章节标题增加了多余的井号修正为正确层级 2. 新增鸿蒙小程序发布完整流程章节 3. 更新版本特性和构建脚本说明,新增极限压缩优化、harmony.patch.js等内容
This commit is contained in:
40
readme.md
40
readme.md
@@ -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. **运维人员操作流程**:
|
||||
- 解压压缩包
|
||||
- 打开鸿蒙开发者工具,导入解压后的代码目录
|
||||
- 验证代码无报错后,执行上传发布操作
|
||||
|
||||
##### ##### ##### ##### 【本地设置】
|
||||

|
||||
#####
|
||||
---
|
||||
@@ -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 替换时间戳
|
||||
- 构建脚本幂等性修复,支持多次运行不产生重复注入
|
||||
|
||||
Reference in New Issue
Block a user