中国 帮助

快速开始

环境要求 工具 版本 Node.js = 18 npm = 9 后端 已启动,地址配在 src/config.js 安装 bash cd wujiesuniapp npm install 启

快速开始
封面

> 本文整理自平台文档 docs/wujies/5.x/frontends/h5/quickstart.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-6edaf1d5fe43-cover.svg)

环境要求

工具版本
Node.js>= 18
npm>= 9
后端已启动,地址配在 src/config.js

安装

cd wujies-uniapp
npm install

启动 H5

npm run dev:h5

终端会打印实际访问地址——本仓库 vite.config.js 里写死了 server.port: '3002'(不是 Vite 默认的 5173),手机浏览器访问时把 localhost 换成电脑局域网 IP。

> 真机调试时,src/config.js 的 baseUrl 不能写 localhost,否则手机访问的是手机自己。改成开发机的局域网地址(形如 http://<电脑IP>:8086/),并确认防火墙放行。

> vite.config.js 里那条 /dev-api 代理指向 http://localhost:8080,对本工程不起作用:移动端所有请求都走 config.js 的绝对 baseUrl,不经过 dev server。改端口、改后端地址请改 src/config.js,别改这里。

生产构建

npm run build:h5

产物在 dist/build/h5/,整个目录交给 Nginx 即可。

location / {
  try_files $uri $uri/ /index.html;
}

如果部署在子路径(例如 /h5/),需要同时改 uni-app 的 h5.router.base 和 Nginx location,否则静态资源 404。

验收

1. 页面能打开,底部 tabBar 正常; 2. 登录后能拿到 token; 3. 商品 / 会员等页面有数据(说明 /open、/portal 接口通); 4. 浏览器控制台没有跨域报错。

src="/images/docs/h5-login.png" caption="H5 登录页(截图占位)" hint="建议 390 × 844。" aspect="9 / 19.5" />

常见问题

现象先查
真机白屏baseUrl 是否还是 localhost;手机与电脑是否同一网段
接口 404对应应用是否安装(见 [C 端接口与应用](/docs/wujies/5.x/frontends/pc/open-api))
静态资源 404部署子路径与 h5.router.base 是否一致
登录后立即退出token 存储、请求头、后端会话配置

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-6edaf1d5fe43-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容