docs: 更新 readme 反映 H5 自动 ZIP 打包和统一配置方式

This commit is contained in:
2026-05-11 11:56:37 +08:00
parent 6033cc2fa0
commit dee2887026
2 changed files with 111 additions and 64 deletions

View File

@@ -83,37 +83,24 @@
📌 **测试版**保留原有 `/hwappx/test/`
💡 **个性化定制示例**:`/hwappx/2811/`,其中 2811 为定制化版客户编号
3. 选择菜单栏「发行」 → 「自定义发行」 →(「H5-xcx.aigc-quickapp.com」查看.local.config.js中站点的网址前缀,站点的网址前缀是什么就选自定义发行中相同的格式)
例如:网址是5g.aigc-quickapp.com,自定义发行就选H5-5g.aigc-quickapp.com
网址是dev.aigc-quickapp.com,自定义发行就选H5-xcx.aigc-quickapp.com
3. 选择菜单栏「发行」 → 「自定义发行」 → 选择对应的站点脚本
💡 例如:网址是 `5g.aigc-quickapp.com` 选 `H5-5g.aigc-quickapp.com`
4. 修改以下配置:
1. **网站标题**:快应用
2. **网站域名**:当前客户域名(示例:xcx.aigc-quickapp.com或者5g.aigc-quickapp.com)
2. **网站域名**:当前客户域名
3. 确认后点击「发行」等待构建完成
⚠️ **注意**:底部控制台弹出“项目 lucky_shop 导出Web成功,路径为:D:\项目文件\项目根目录\unpackage\dist\build\web”后再执行下一步
💡 **示例**:`项目 lucky_shop 导出Web成功,路径为:D:\0.项目源码\lucky_shop\unpackage\dist\build\web`
5. 按控制台提示的路径找到 `web` 目录,将该目录下所有文件手动打包成一个 `.zip` 压缩包
*仅打包文件,不包含外层 web 目录*
⚠️ **注意**:构建完成后自动输出到 `unpackage/dist/build/h5/`,格式为 `{域名}-{base路径}.zip`
💡 **示例**:`xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip`
##### 4.2.1.2 【重命名】
1. 按版本类型规范重命名压缩包:
- **通用版**:`hwappx-common-域名-时间.zip`
💡 **示例**:`hwappx-common-xcx.aigc-quickapp.com-2026-01-24.zip`
- **定制化版**:`客户名称-定制化---hwappx-客户编号-域名-时间.zip`
💡 **示例**:`POCT检测分析平台-定制化---hwappx-2811-xcx.aigc-quickapp.com-2026-01-24.zip`
🚫 **禁止**:压缩包命名禁止包含 `/ \ : * ? " < > |` 等特殊字符
##### 4.2.1.3 【交付与最终发布】🔍
1. 将重命名后的压缩包发送给运维人员
##### 4.2.1.2 【交付与最终发布】🔍
1. 将生成的 `.zip` 文件发送给运维人员
2. **运维人员操作流程**:
1. 解压压缩包
2. 打开快应用开发者工具,导入解压后的代码目录
3. 验证代码无报错后,执行上传发布操作
##### 4.2.1.3 【测试流程】
##### 4.2.1.3 【测试流程】
H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/common/?uniacid=75)改站点
如果是test就把hwappx/common/改为hwappx/test/----------改站点
@@ -134,22 +121,40 @@ H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
- **commitId**:当前构建的 Git 短提交 ID
- **buildTime**:构建时间
> **开发模式**:HMR 热更新时自动跳过重复注入,不影响开发体验。
> **开发模式**:HMR 热更新时由 webpack emit 钩子自动处理,不影响开发体验。
### 5.2 可用的 npm 脚本命令
### 5.2 自动 ZIP 打包
| 命令 | 说明 |
**H5 自定义发行**构建完成后自动执行:
| 步骤 | 说明 |
|------|------|
| `npm run mp-weixin` | 拷贝 site.js + config 文件 + 创建 ZIP 压缩包(用于手动触发) |
| 重命名输出目录 | `{域名}-{base路径用.连接}`(如 `xcx.aigc-quickapp.com-hwappx.common`) |
| 创建 ZIP 文件 | 文件名格式:`{目录名}-{Git提交ID}-{上海时区时间戳}.zip` |
| 清理 | ZIP 创建完成后自动删除源目录 |
> 生产构建时,ZIP 打包由构建插件自动触发,通常无需手动执行此命令。
💡 **示例 ZIP**:`xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip`
### 5.3 构建后处理功能(mp-weixin.patch.js)
**微信小程序**生产构建时自动执行:
- 拷贝 `site.js` / `project.config.json` / `project.private.config.json` 到构建目录
- 创建 ZIP 包(文件名包含 Git 提交 ID)
- 复制 `project.config.json` 和 `project.private.config.json` 到构建目录
- 复制 `site.js` 到构建目录
- 创建 ZIP 压缩包(文件名包含 Git 提交 ID)
- 自动打开 ZIP 文件所在目录
### 5.3 环境配置
域名配置统一通过 `package.json` 中各脚本的 `env.UNI_APP_DOMAIN` 传入:
```json
"h5-xcx.aigc-quickapp.com": {
"title": "...",
"env": {
"UNI_PLATFORM": "h5",
"UNI_APP_DOMAIN": "https://xcx.aigc-quickapp.com/"
},
"define": { "PRODUCTION": true }
}
```
`config.js` 和 `vue.config.js` 均通过 `process.env.UNI_APP_DOMAIN` 读取,**新增/删除脚本无需改动代码**。
---