129 lines
4.4 KiB
Markdown
129 lines
4.4 KiB
Markdown
# 小程序及快应用前端源码
|
||
|
||
来源于外包提供的源代码，"0731xcx20微信小程序(1).zip"
|
||
|
||
|
||
## 项目说明
|
||
|
||
该项目基于 uniapp 开发构建，请使用(HBuilderX)[https://www.dcloud.io/hbuilderx.html] 进行代码开发及构建发布。
|
||
|
||
## 开发说明
|
||
|
||
1. 源码基于Vue2版本，scss采用node-sass进行编译输出。
|
||
|
||
|
||
## 开发调试说明
|
||
|
||
### 注意点
|
||
|
||
应用访问等关键参数的配置来源于 `./common/js/config.js`
|
||
|
||
### 小程序调试
|
||
|
||
|
||
|
||
## 发布说明
|
||
|
||
### 小程序发布
|
||
|
||
基本操作步骤：
|
||
|
||
#### 微信小程序发布基本操作步骤：（定制/通用版）
|
||
|
||
### 【前置准备】
|
||
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为客户编号 → 用微信开发者工具导入mp-weixin目录 → 编译验证无误后 → 上传代码。
|
||
|
||
|
||
参照：`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://tsaas.liveplatform.cn/',
|
||
|
||
// 图片域名
|
||
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. 选择菜单栏 "发行" -> "快应用"，进行发布构建
|
||
3. 使用快应用开发者工具打开发布后的代码进行上传发布 |