> 本文整理自平台文档 docs/wujies/5.x/frontends/h5/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-c68a13bd2d2b-cover.svg)
H5 是 wujies-uniapp 的一个编译目标:和 App、小程序共用一套 uni-app 代码,只是构建命令、运行容器和部分能力不同。
- 工程目录:
wujies-uniapp/ - 包名:
wujies-uniapp - 技术栈:uni-app + Vue 3 + uview-plus
- 接口配置:
src/config.js的baseUrl
H5 适合什么
| 场景 | 说明 |
|---|---|
| 微信内打开 | 分享链接、公众号菜单、扫码进入 |
| 手机浏览器 | 不想安装 App 的用户 |
| 快速验证 | 改完页面直接刷新,不需要打包 |
| 活动 / 落地页 | 独立部署、独立域名 |
代码结构
wujies-uniapp/
├── src/
│ ├── config.js ★ 后端地址、clientID、加密开关、RSA 密钥
│ ├── manifest.json 应用名称 / 图标 / 各端配置
│ ├── pages.json 页面路由与 tabBar(分包也在这里声明)
│ ├── pages/ 主包页面
│ ├── pages_mall/ 商城分包
│ ├── pages_member/ 会员分包
│ ├── pages_mine/ 个人中心
│ ├── pages_social/ 社交
│ ├── pages_message/ 消息
│ ├── pages_search/ 搜索
│ ├── pages_service/ 客服 / 服务
│ ├── pages_tools/ 工具类分包
│ ├── api/ 接口定义(按业务域分目录)
│ ├── store/ Vuex(登录态、用户信息)
│ ├── components/ 公共组件
│ ├── uni_modules/ 插件市场组件
│ ├── utils/
│ │ └── request.ts ★ 请求封装(拼 baseUrl、带 token、401、加解密)
│ └── static/
└── vite.config.js dev 端口 3002、base './'
src="/images/docs/h5-home.png" caption="H5 首页(截图占位)" hint="建议 390 × 844(iPhone 14)或 750 宽设计稿,截首页首屏。" aspect="9 / 19.5" />
与后端的关系
和 PC 用户端一样,移动端调用的 /open/ 由已安装应用提供(当前实际用到的是图床 wujies-gallery-plugin 的 /open/gallery/)。接口 404 时先确认应用装没装,再查路径。登录、注册、验证码走宿主的 /auth/、/register、/captcha/。
> src/api/mobile/ 里还有一批 /mobile/ 接口(约 50 个调用点),后端目前没有任何控制器挂在这个前缀下,装哪个应用都不会通;这些页面是早期遗留,照抄会一路 404。判断标准仍然是那句:接口在不在,取决于装了什么应用 + 这个前缀后端有没有实现。
继续读
- [快速开始](/docs/wujies/5.x/frontends/h5/quickstart)
- [环境与接口配置](/docs/wujies/5.x/frontends/h5/config)
- App 端:[总览](/docs/wujies/5.x/frontends/app/) · [打包发布](/docs/wujies/5.x/frontends/app/build)
- 小程序端:[小程序端](/docs/wujies/5.x/frontends/app/mp)
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-c68a13bd2d2b-guide.svg)


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