174 lines
5.0 KiB
Markdown
174 lines
5.0 KiB
Markdown
# 小程序及快应用前端源码
|
||
|
||
来源于外包提供的源代码，"0731xcx20微信小程序(1).zip"
|
||
|
||
|
||
## 项目说明
|
||
|
||
该项目基于 uniapp 开发构建，请使用(HBuilderX)[https://www.dcloud.io/hbuilderx.html] 进行代码开发及构建发布。
|
||
|
||
## 开发说明
|
||
|
||
1. 源码基于Vue2版本，scss采用node-sass进行编译输出。
|
||
|
||
|
||
## 开发调试说明
|
||
|
||
### 注意点
|
||
|
||
应用访问等关键参数的配置来源于 `./common/js/config.js`
|
||
|
||
### 小程序调试
|
||
|
||
|
||
|
||
## 发布说明
|
||
|
||
### 小程序发布
|
||
|
||
基本操作步骤：
|
||
|
||
1. 使用HBuilderX打开项目
|
||
2. 选择菜单栏 "发行" -> "小程序-微信"，进行发布构建
|
||
3. 然后在终端进入项目根目录，执行 `npm run mp-weixin` 手动输出构建包。例如：mp-weixin-2025-10-31-1761881054836.zip（改id）
|
||
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',
|
||
|
||
//客服地址
|
||
webSocket: '{{$webSocket}}',
|
||
|
||
//本地端主动给服务器ping的时间, 0 则不开启 , 单位秒
|
||
pingInterval: 1500,
|
||
|
||
// 版本号
|
||
version: '1.0'
|
||
};
|
||
|
||
export default config;
|
||
```
|
||
|
||
|
||
### 快应用发布
|
||
1. 使用HBuilderX打开项目
|
||
2. 点击项目中【⚙】manifest.jion--->web配置--->运行的基础路径--->/hwappx/改编号/
|
||
"h5" : {
|
||
"sdkConfigs" : {
|
||
"maps" : {
|
||
"qqmap" : {
|
||
"key" : "TUHBZ-CNWKU-UHAVP-GZQ26-HNZFO-3YBF4"
|
||
}
|
||
}
|
||
},
|
||
"router" : {
|
||
"mode" : "history",
|
||
"base" : "/hwappx/2811/"
|
||
},
|
||
|
||
（编号可以在.local.config.js中找到需要的编号）
|
||
|
||
const localDevConfig = ({
|
||
'460': { // 制氧设备平台
|
||
uniacid: 460,
|
||
domain: 'https://xcx30.5g-quickapp.com/',
|
||
},
|
||
'576-xcx30.5g': { // 活性石灰装备
|
||
uniacid: 576,
|
||
domain: 'https://xcx30.5g-quickapp.com/',
|
||
},
|
||
'2285': { // 数码喷墨墨水
|
||
uniacid: 2285,
|
||
domain: 'https://xcx.aigc-quickapp.com/',
|
||
},
|
||
'2811': { // POCT检测分析平台
|
||
uniacid: 2811,
|
||
domain: 'https://xcx6.aigc-quickapp.com/',
|
||
},
|
||
'2724': { // 生物菌肥
|
||
uniacid: 2724,
|
||
domain: 'https://xcx.aigc-quickapp.com/',
|
||
},
|
||
'2505': { // 煤矿钻机
|
||
uniacid: 2505,
|
||
domain: 'https://xcx.aigc-quickapp.com/',
|
||
},
|
||
'2777': { // 养老服务
|
||
uniacid: 2777,
|
||
domain: 'https://xcx.aigc-quickapp.com/',
|
||
},
|
||
'1': { // 开发平台
|
||
uniacid: 1,
|
||
domain: 'https://dev.aigc-quickapp.com',
|
||
},
|
||
'1-test': { // 测试平台
|
||
uniacid: 1,
|
||
domain: 'https://test.aigc-quickapp.com',
|
||
},
|
||
})['2811']; // 选择要使用的环境配置
|
||
3. 选择菜单栏 "发行" ->自定义发行--->H5-xcx.aigc-quickapp.com "快应用"，网站标题为"快应用" 域名为xcx.aigc-quickapp.com 进行发布构建
|
||
4. 在电脑本地文件夹里找到unpackage--->dist--->build--->h5中h5-xcx.aigc-quickapp.com--->进行手动打包，例如：static.zip（可以写上id 例如 POCT检测分析平台-定制化-2026-01-06.zip）
|
||
5. 然后将压缩包发给开发定制客户技术人员，
|
||
6. 使用快应用开发者工具打开发布后的代码进行上传发布 |