Compare commits

...

2 Commits

Author SHA1 Message Date
Zhukj
2a1f33323c chore:修改readme.md小程序和快应用发布说明文档 2026-01-24 16:51:31 +08:00
Zhukj
b441c46993 chore:更新小程序发布说明文档 2026-01-24 11:19:53 +08:00
2 changed files with 81 additions and 86 deletions

View File

@@ -103,7 +103,7 @@
}, },
"router" : { "router" : {
"mode" : "history", "mode" : "history",
"base" : "/hwappx/common/" "base" : "/hwappx/2811/"
}, },
"title" : "", "title" : "",
"devServer" : { "devServer" : {

165
readme.md
View File

@@ -1,7 +1,5 @@
# 小程序及快应用前端源码 # 小程序及快应用前端源码
来源于外包提供的源代码,"0731xcx20微信小程序(1).zip"
## 项目说明 ## 项目说明
@@ -9,7 +7,7 @@
## 开发说明 ## 开发说明
1. 源码基于Vue2版本scss采用node-sass进行编译输出。 源码基于Vue2版本scss采用dart-sass进行编译输出。
## 开发调试说明 ## 开发调试说明
@@ -18,7 +16,7 @@
应用访问等关键参数的配置来源于 `./common/js/config.js` 应用访问等关键参数的配置来源于 `./common/js/config.js`
### 小程序调试
@@ -26,93 +24,90 @@
### 小程序发布 ### 小程序发布
基本操作步骤:
1. 使用HBuilderX打开项目
2. 选择菜单栏 "发行" -> "小程序-微信",进行发布构建
3. 然后在终端进入项目根目录,执行 `npm run mp-weixin` 手动输出构建包。例如mp-weixin-2025-10-31-1761881054836.zip
4. 然后将mp-weixin-2025-10-31-1761881054836发给微信开发定制客户技术人员
5. 定制客户技术人员可以修改解压后修改项目根目录下的site.js进行针对客户的信息配置然后使用微信开发者工具打开发布后的代码进行上传发布
参照:`common\js\config.js` 文件内容说明:
```js
// 发行版本,配置说明
let releaseCfg = undefined;
try {
if (site) {
releaseCfg = {
baseUrl: site.baseUrl,
imgDomain: site.baseUrl,
h5Domain: site.baseUrl,
uniacid: site.uniacid,
}
}
} catch (e) {}
// 调试版本,配置说明
const devCfg = {
// 商户ID
uniacid: 460, //825
//api请求地址
baseUrl: 'https://xcx30.5g-quickapp.com/',
// 图片域名
imgDomain: 'https://xcx30.5g-quickapp.com/',
// H5端域名
h5Domain: 'https://xcx30.5g-quickapp.com/',
// // api请求地址
// baseUrl: 'https://tsaas.liveplatform.cn/',
// // 图片域名
// imgDomain: 'https://tsaas.liveplatform.cn/',
// // H5端域名
// h5Domain: 'https://tsaas.liveplatform.cn/',
// api请求地址
// baseUrl: 'http://saas.cn/',
// // 图片域名
// imgDomain: 'http://saas.cn/',
// // H5端域名
// h5Domain: 'http://saas.cn/',
};
var config = {
/**
* 1.开发调试模式
* 去掉注释 ...devCfg;
* 注释掉 ...releaseCfg,
* 2.发行/发布模式,例如通过`HBuilder>发行>小程序微信`的时候,原理
* 然后将 `import site from "../site.js";`追加到 `unpackage\dist\build\mp-weixin\common\vendor.js` 文件内容开头部分
* 然后将 site.js 文件放到 `unpackage\dist\build\mp-weixin\` 目录下面
*/
...(releaseCfg ?? devCfg),
// 腾讯地图key #### 基本操作步骤:(通用版/定制化版)
mpKey: 'TUHBZ-CNWKU-UHAVP-GZQ26-HNZFO-3YBF4',
#### 【前置准备】
1. 在项目根目录打开终端安装依赖“npm install”已有依赖可跳过此步骤
#### 【发布构建】
2. 使用HBuilderX打开项目
3. 选择菜单栏「发行」 → 「小程序-微信」→ 「发行」,等待构建完成。(⚠️注:底部控制台弹出"请在微信小程序开发者工具中点击上传"后再执行下一步);
4. 打开资源管理器→项目根目录,右键选择「在终端中打开」,执行"npm run mp-weixin"命令并回车;
5. 找到项目根目录 /unpackage/dist/build 下生成的 mp-weixin 压缩包
💡例如mp-weixin-2026-01-23-1769152056146.zip;同时该目录下会生成未压缩的 mp-weixin 目录。
#### 【验证与重命名】
6. 打开该目录下同时生成未压缩的 mp-weixin 目录找到site.js文件将文件内的uniacid值改为当前客户编号2812并保存
7. 打开微信开发者工具导入「mp-weixin」目录点击「编译」在开发者工具控制台验证有无报错以及能否返回对应客户的业务数据
8. 确保无误后将生成的mp-weixin的压缩包重命名格式为定制化-客户编号-域名-mp-weixin-当前日期-生成编号.zip。
***(📌通用版无需重命名)***
💡例如custom-2812-xcx.aigc-quickapp.com-mp-weixin-2026-01-22-1769152056146.zip
🚫压缩包命名禁止包含 / \ : * ? " < > | 等特殊字符。
#### 【交付与最终发布】🔍🔍
9. 将重命名后的文件发送给技术人员; ***(📌通用版直接将生成的 mp-weixin 压缩包直接发送给技术人员)***
10. 技术人员操作:解压压缩包 → 确认site.js中的uniacid为客户编号 → 用微信开发者工具导入解压后的代码目录 → 编译验证无误后 → 上传发布。
//客服地址
webSocket: '{{$webSocket}}',
//本地端主动给服务器ping的时间, 0 则不开启 , 单位秒
pingInterval: 1500,
// 版本号
version: '1.0'
};
export default config;
```
### 快应用发布 ### 快应用发布
1. 使用HBuilderX打开项目
2. 选择菜单栏 "发行" -> "快应用",进行发布构建
3. 使用快应用开发者工具打开发布后的代码进行上传发布 #### 基本操作(通用版/定制化版)
#### 【发布构建】
1. 使用HBuilderX打开项目
2. 打开项目根目录的manifest.json文件切换至可视化配置界面依次点击「Web 配置」→「运行的基础配置」,修改路径中的客户编号;***(📌通用版保留原有/hwappx/common/***
💡例如:/hwappx/2811/其中2811为定制化版客户编号
3. 选择菜单栏「发行」 → 「自定义发行」 →「H5-xcx.aigc-quickapp.com」先修改以下配置
网站标题:快应用
网站域名当前客户域名示例xcx.aigc-quickapp.com
确认后点击「发行」等待构建完成。
⚠️注:底部控制台弹出“项目 lucky_shop 导出Web成功路径为D:\项目文件\项目根目录\unpackage\dist\build\web”后再执行下一步
💡例如:项目 lucky_shop 导出Web成功路径为D:\0.项目源码\lucky_shop\unpackage\dist\build\web
4. 按控制台提示的路径找到web目录将该目录下所有文件手动打包成一个.zip压缩包仅打包文件不包含外层web目录
#### 【重命名】
5. 按版本类型规范重命名压缩包:
📌通用版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
🚫压缩包命名禁止包含 / \ : * ? " < > | 等特殊字符
#### 【交付与最终发布】🔍🔍
6. 将重命名后的压缩包发送给运维人员;
7. 运维人员操作:
① 解压压缩包;
② 打开快应用开发者工具,导入解压后的代码目录;
③ 验证代码无报错后,执行上传发布操作。