跳转到内容

mall4cloud-uniapp项目启动准备

S2B2C 白洞版 · mall4cloud-uniapp项目启动准备

示例值注意事项:本文中的 IP、域名、账号、密码等仅为示例,请按你的实际环境替换。

  • 适用于二开技术团队在对应模块下的开发、调试或配置工作。
  • 已拉取对应项目源码并具备基础运行环境。
  • 已根据实际环境替换文中的示例配置值。

mall4cloud-uniapp:本项目结合了vue脚手架可在vscoded等主流编辑器输入指令 安装、运行和打包。兼容h5、小程序、app端多端开发

项目要求 20.19+ || 22.12+,推荐使用 LTS 版本

如果不了解怎么安装nodejs的,可以参考

项目要求使用 包管理工具,版本要求:>=8 <11

使用编辑器打开项目,在根目录执行以下命令安装依赖

pnpm install

如果不想使用 pnpm,请删除 package.json 文件中 pnpm 相关内容后再进行安装

{
"scripts" : {
"preinstall": "npx only-allow pnpm" // 删除此行
},
"engines": {
"pnpm": ">=8 <11" // 删除此行
},
"pnpm": { // 删除此项
...
}
}

uniapp项目是兼容多端的,所以不同的端要有不同的配置

  1. h5会分为两种,一种是在微信上打开的h5页面,一种是在浏览器打开的h5页面。在微信打开的h5页面,是需要公众号服务的,其中的微信支付,是jsapi支付。在手机浏览器打开的,是h5支付,属于不同的范畴。

在进行公众号打开页面的时候,因为需要进行微信公众号支付,还有微信公众号的登陆授权,所以需要配置微信公众号的appid

修改.env.development

Terminal window
# 微信公众号appid
VITE_APP_MP_APPID = 'wx42bbe857570c5b40'
  1. 对于小程序,是需要配置小程序的appid

修改manifest.json 在非源码视图,选择需要运行的模式,修改里面的参数,如修改微信小程序配置-微信小程序appid 从而运行微信小程序。

修改.env.development 连接后台。

假设你的服务器ip为192.168.1.195,也就是说你运行java项目的那台机器的开发环境,打开cmd 输入ipconfig 按回车的时候,看到的ipv4地址为192.168.1.195 当然这个ip也是假设的。

假设java 网关运行的端口是8000,具体请看java项目中的bootstrap.yml

那么开发环境的配置为

Terminal window
# 客服websocket接口请求地址,https对应wss,http对应ws
VITE_APP_WEBSOCKET_URL = 'ws://192.168.1.195:8000'
VITE_APP_BASE_API = 'http://192.168.1.195:8000'

修改manifest.json 里面的port,可以改前端h5启动的端口

"h5": {
"devServer": {
"port": 80
},
}

h5:

hbuilder开发工具上面的菜单选择:运行-> 运行到浏览器 -> chrome

小程序:

运行到小程序的前提是,你已经下载好了

hbuilder开发工具上面的菜单选择:运行-> 运行到小程序模拟器 -> 微信开发者工具

h5:

Terminal window
npm run dev:h5

小程序:

运行到小程序的前提是,你已经下载好了

Terminal window
npm run build:mp-weixin

执行完上述命令可在项目目录下 dist/build/ 中找到 mp-weixin 右键打开文件所在资源地址

双击mp-weixin进入到文件内部 双击app.wxss 打开小程序

vscode打开微信小程序步骤1

vscode打开微信小程序步骤2

  • 根据文中步骤完成后,确认对应功能可访问或服务可正常启动。
  • 可先查看故障排查索引:../../04-故障排查/README.md
  • 当前目录索引:README.md