跳转到内容

mall4cloud-multishop-uniapp生产环境搭建

S2B2C 白洞版 · mall4cloud-multishop-uniapp生产环境搭建

如需添加更多环境变量,请以 VITE_APP_ 开头声明

Section titled “如需添加更多环境变量,请以 VITE_APP_ 开头声明”

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

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

mall4ms-bbc:uniapp项目,可发行为H5、android/ios app

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

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

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

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

Terminal window
pnpm install

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

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

修改 .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标识,用于跳转应用
Terminal window
# 如需添加更多环境变量,请以 VITE_APP_ 开头声明
# 在代码中使用 import.meta.env.VITE_APP_XXX 获取指定变量
# 环境配置标识
VITE_APP_ENV = 'production'
# 微信公众号appid
VITE_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/'
# 天地图key
VITE_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

  1. 项目配置 manifest.json 修改h5节点配置

    {
    "h5": {
    "router": {
    "base": "/ms/"
    }
    }
    }
  2. nginx 配置

    location /ms {
    try_files $uri $uri/ /ms/;
    }

参考安卓、ios打包的流程

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