旧物废品回收项目部署教程
旧物废品回收项目部署教程
本项目是基于uni-app开发的旧物/废品回收多端项目，支持微信/支付宝/抖音等小程序、H5、Android/IOS APP端部署，技术栈包含Vue3、SCSS、uni-ui、api工厂前端中台，遵循MulanPSL-2.0开源协议。
一、部署前环境准备
- 开发工具：安装HBuilderX（最新正式版），下载地址：https://www.dcloud.io/hbuilderx.html
- 小程序调试工具：安装微信开发者工具（最新版），下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
- 微信小程序ID：申请微信小程序测试号/正式号，测试号申请地址：https://mp.weixin.qq.com/wxamp/sandbox?doc=1
- api工厂账号：注册api工厂测试账号，用于后台数据配置、接口对接
二、获取项目代码
方式1：Git克隆
git clone https://gitee.com/javazj/recycle.git
方式2：下载ZIP压缩包
访问https://gitee.com/javazj/recycle，点击克隆/下载→下载ZIP，解压至本地非中文、无空格目录，提取包含App.vue的最内层文件夹，避免目录嵌套。
三、api工厂后台配置
- 登录api工厂后台，进入工厂设置→数据克隆，商户号输入150，完成测试数据克隆后刷新页面
- 进入平台设置→微信小程序，填写微信小程序appid和secret并保存
- 进入工厂设置→商户信息，记录subDomain（专属域名）和merchantId（商户ID）
四、HBuilderX项目配置
4.1 导入项目
打开HBuilderX，文件→导入→从本地导入项目，选择项目根目录（含App.vue）
4.2 修改manifest.json配置
打开manifest.json，切换至微信小程序配置，勾选微信小程序，替换为自身微信小程序AppID并保存
4.3 修改config.js配置
打开config.js，将subDomain和merchantId替换为api工厂后台记录的参数并保存
五、本地运行与调试
5.1 微信小程序端调试
- 微信开发者工具→设置→安全设置，开启服务端口
- HBuilderX右键项目→运行→运行到小程序模拟器→微信开发者工具
- 等待编译完成，在微信开发者工具中调试项目
5.2 H5端调试
HBuilderX右键项目→运行→运行到浏览器，选择浏览器打开H5页面调试
六、微信小程序上线配置
6.1 开通接口权限
微信公众平台→开发→接口设置，申请开通getLocation地理位置接口
6.2 订单中心路径配置
提交审核时，小程序订单中心path：
pages/shop/order-list
6.3 订单发货功能配置
微信公众平台→订单管理→发货接入，配置地址：
pages/shop/order-detail?payOrderNo=${商品订单号}
api工厂后台→商城管理→订单设置，开启同步发货状态到微信小程序
6.4 打包上传审核
HBuilderX右键项目→发行→发行到微信小程序，编译后在微信开发者工具上传，微信公众平台提交审核
七、核心配置文件说明
- generate-share-image.js：积分获取功能配置
- manifest.json：小程序分享、平台权限配置
- config.js：项目中台对接、基础配置
- sub_packages/course：课程中心功能模块
- pages/shop：积分商城、订单管理功能模块
八、常见问题与注意事项
- 运行报错：检查项目目录无中文、无空格、无嵌套，开发工具为最新版，微信开发者工具开启服务端口
- 登录失败：核对manifest.json的AppID、config.js的subDomain和merchantId
- 功能限制：微信专属功能仅在小程序端可用，H5端不支持
- 问题反馈：Gitee仓库提交ISSUES，贡献代码可提交PR
九、项目维护与拓展
- 项目更新：使用git pull拉取最新源码
- 多端部署：在manifest.json配置对应平台参数，支持支付宝、抖音、小红书小程序
- 功能拓展：可基于现有模块二次开发回收、商城、课程相关功能