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

来源于外包提供的源代码，"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  公版--例如 hwappx-common-xcx.aigc-quickapp.com-2026-01-09.zip
            定制化--例如 POCT检测分析平台-定制化--- hwappx-2811-xcx.aigc-quickapp.com-2026-01-09.zip）
5. 然后将压缩包发给开发定制客户技术人员，
6. 使用快应用开发者工具打开发布后的代码进行上传发布