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

来源于外包提供的源代码，"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. 点击项目中unpackage下面第六个【⚙】manifest.jion--->web配置--->运行的基础路径--->/hwappx/改编号/（编号可以在.local.config.js中找到需要的编号----.local.config.js在【⚙】manifest.jion上面第4个）
3. 选择菜单栏 "发行" ->自定义发行--->H5-xcx.aigc-quickapp.com "快应用"，进行发布构建
4. 在电脑本地文件夹里找到unpackage--->dist--->build--->h5中h5-xcx.aigc-quickapp.com--->进行手动打包，例如：mp-weixin-2025-10-31-1761881054836.zip（可以写上id）
5. 然后将压缩包发给开发定制客户技术人员，
6. 使用快应用开发者工具打开发布后的代码进行上传发布