mall4cloud-multishop-uniapp生产环境搭建
S2B2C 白洞版 · mall4cloud-multishop-uniapp生产环境搭建
如需添加更多环境变量,请以 VITE_APP_ 开头声明
Section titled “如需添加更多环境变量,请以 VITE_APP_ 开头声明”示例值注意事项:本文中的 IP、域名、账号、密码等仅为示例,请按你的实际环境替换。
- 适用于二开技术团队在对应模块下的开发、调试或配置工作。
- 已拉取对应项目源码并具备基础运行环境。
- 已根据实际环境替换文中的示例配置值。
mall4ms-bbc:uniapp项目,可发行为H5、android/ios app
1. 安装nodejs + 淘宝npm镜像
Section titled “1. 安装nodejs + 淘宝npm镜像”项目要求 20.19+ || 22.12+,推荐使用 LTS 版本
如果不了解怎么安装nodejs的,可以参考
2. 安装依赖
Section titled “2. 安装依赖”项目要求使用 包管理工具,版本要求:>=8 <11
使用编辑器打开项目,在根目录执行以下命令安装依赖
pnpm install如果不想使用 pnpm,请删除 package.json 文件中 pnpm 相关内容后再进行安装
{ "scripts" : { "preinstall": "npx only-allow pnpm" // 删除此行 }, "engines": { "pnpm": ">=8 <11" // 删除此行 }, "pnpm": { // 删除此项 ... }}3.修改配置文件,连接后台
Section titled “3.修改配置文件,连接后台”修改 .env.production 连接后台。
VITE_APP_MP_APPID:微信公众号appid
VITE_APP_BASE_API:mall4ms-bbc这个项目连接的是multishop.jar提供的接口VITE_APP_WS_IM_API:websocket,访问wukongim中间件提供的ws端口VITE_APP_H5_DOMAIN:域名地址配置-用于分享时跳转链接VITE_APP_MERCHANT_URL:商家端后台地址(pc) ,部分功能受限时展示地址指示用户到PC端操作VITE_APP_RESOURCES_URL: 对应七牛云 or 阿里云的图片域名地址VITE_APP_MAP_KEY:天地图key,用于地图相关功能VITE_APP_URL_SCHEMES:App标识,用于跳转应用
# 如需添加更多环境变量,请以 VITE_APP_ 开头声明# 在代码中使用 import.meta.env.VITE_APP_XXX 获取指定变量
# 环境配置标识VITE_APP_ENV = 'production'
# 微信公众号appidVITE_APP_MP_APPID = 'wx42bbe857570c5b40'
# 统一接口域名VITE_APP_BASE_API = 'https://cloud-api.mall4j.com'
# 客服webstock接口请求地址VITE_APP_WEBSOCKET_URL = 'wss://cloud-im.mall4j.com'
# 移动端域名地址配置VITE_APP_H5_DOMAIN = 'https://h5.mall4j.com/cloud/'
# 商家端后台地址(pc)VITE_APP_MERCHANT_URL = 'https://cloud-multishop.mall4j.com'
# 图片域名VITE_APP_RESOURCES_URL = 'https://mall4cloud.oss-cn-guangzhou.aliyuncs.com/'
# 天地图keyVITE_APP_MAP_KEY = ''
# h5或其它app打开当前App的自定义UrlSchemes,还需要在manifest.json -> app-plus -> android/schemes 与 ios urltypes 中进行配置 (二者需要一致) (不可与用户移动端的urlSchemes相同)VITE_APP_URL_SCHEMES = 'lanhaicloudms'如需部署在二级目录下,需要修改以下配置
Section titled “如需部署在二级目录下,需要修改以下配置”假设部署在 h5 目录,即访问的地址为 https://xxxx.xxx/ms
-
项目配置
manifest.json修改h5节点配置{"h5": {"router": {"base": "/ms/"}}} -
nginx 配置
location /ms {try_files $uri $uri/ /ms/;}
4.2 发行为APP
Section titled “4.2 发行为APP”参考安卓、ios打包的流程
- 根据文中步骤完成后,确认对应功能可访问或服务可正常启动。
- 可先查看故障排查索引:
../../04-故障排查/README.md
- 当前目录索引:
README.md