# 小程序及快应用前端源码

来源于外包提供的源代码，"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. 使用快应用开发者工具打开发布后的代码进行上传发布