跳转到内容

mall4uni-cbec-b2c项目的搭建

跨境单商户版 · mall4uni-cbec-b2c项目的搭建

mall4uni-cbec-b2c:uni代表uniapp,可发行为H5、小程序、android/ios app

项目要求最低 18.12.0,推荐 20.9.0

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

项目要求使用 包管理工具

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

Terminal window
pnpm install

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

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

在本文件所在的目录下有个yami-shop/nginx/conf.d 文件夹,里面有nginx的一些配置信息

修改 .env.production 连接后台。

  • VITE_APP_MP_APPID :微信公众号appid
  • VITE_APP_URL_SCHEMES:App标识,用于跳转应用
  • VITE_APP_BASE_API : mall4uni-cbec-b2c 这个项目连接的是api.jar提供的接口
  • VITE_APP_WS_IM_API : 当然他们还需要与用户进行客服消息通讯,所以也要连接websocket,访问wukongim中间件提供的ws端口
  • VITE_APP_H5_DOMAIN:域名地址配置-用于分享时跳转链接
  • VITE_APP_RESOURCES_URL : 当然他们还要访问七牛云 or 阿里云的图片,也是需要对应的域名地址
  • VITE_APP_MAP_KEY:腾讯地图key,用于地图相关功能
Terminal window
# 如需添加更多环境变量,请以 VITE_APP_ 开头声明
# 在代码中使用 import.meta.env.VITE_APP_XXX 获取指定变量
# 环境配置标识
VITE_APP_ENV = 'production'
# h5或其它app打开当前App的自定义UrlSchemes,还需要在manifest.json -> distribute -> app-plus -> android/schemes 与 ios urltypes 中进行配置 (二者需要一致)
VITE_APP_URL_SCHEMES = 'lanhaib2c'
# 统一接口域名
VITE_APP_BASE_API = 'https://cbec-b2c-api.mall4j.com'
# 客服webstock接口请求地址,https对应wss,http对应ws
VITE_APP_WS_IM_API = 'wss://cbec-b2c-im.mall4j.com'
# 移动端域名地址配置
VITE_APP_H5_DOMAIN = 'https://h5.mall4j.com'
# 图片域名
VITE_APP_RESOURCES_URL = 'https://img.mall4j.com/'
# 腾讯地图key (WebServiceAPI) 用于IP定位 & 地址位置解析
# 同时需要配置到 manifest配置文件 h5 -> sdkConfigs -> maps -> qqmap -> key
VITE_APP_MAP_KEY = ''

manifest.json 配置文件

{
"h5": {
"sdkConfigs" : {
"maps" : {
"qqmap" : {
// 用于h5端ip定位
"key" : ""
}
}
}
}
}

如需部署在二级目录下,需要修改以下配置

Section titled “如需部署在二级目录下,需要修改以下配置”

假设部署在 h5 目录,即访问的地址为 https://xxxx.xxx/h5

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

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

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

参考安卓ios打包的流程