> 本文整理自平台文档 docs/wujies/5.x/frontends/app/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-78a20d9a1c2d-cover.svg)
App 端和 H5、小程序共用 wujies-uniapp/ 的同一套页面代码,区别在运行容器、原生能力和打包流程。
- 工程目录:
wujies-uniapp/ - 应用标识:
src/manifest.json的appid - 版本号:
versionName(展示)/versionCode(升级判断) - 开发命令:
npm run dev:app(或dev:app-android/dev:app-ios)
App 端适合什么
| 场景 | 说明 |
|---|---|
| 需要原生能力 | 相机、定位、推送、文件、蓝牙等 |
| 需要离线 / 常驻 | H5 做不到的本地缓存与后台能力 |
| 应用商店分发 | Android / iOS 上架 |
工程配置
| 文件 | 作用 |
|---|---|
src/manifest.json | 应用名称、appid、图标、启动图、权限、各端配置 |
src/pages.json | 页面路由、tabBar、分包 |
src/config.js | 接口地址与加密开关 |
vite.config.js(根目录) | 构建配置;其中的 /dev-api 代理只对 H5 dev server 生效,App / 小程序不走 |
manifest.json 里需要重点确认:
{
"name": "wujies-vue3",
"appid": "__UNI__XXXXXXX",
"versionName": "1.0.0",
"versionCode": "100"
}
appid必须换成你自己的 DCloud 应用 ID;versionCode每次发版必须递增,否则无法覆盖安装 / 商店拒审;- Android 权限按实际能力申请,不要一次性全量声明。
仓库里这份 manifest.json 的 app-plus.modules 与 app-plus.distribute.sdkConfigs 都是空的: 推送、微信支付、支付宝、定位等原生模块一个都没启用,而 app-plus.distribute.android.permissions 里还是模板自带的那一批。要用哪一项,就得先在 modules / sdkConfigs 里声明并填对应平台参数, 再把那份权限清单删到只剩实际用到的——见[打包发布](/docs/wujies/5.x/frontends/app/build)。
src="/images/docs/app-home.png" caption="App 首页(截图占位)" hint="建议 390 × 844,截首页 + 底部 tabBar。" aspect="9 / 19.5" />
运行
npm run dev:app
- 用 HBuilderX 打开项目,选择「运行 → 运行到手机或模拟器」;
- 或使用 CLI 构建后,把产物导入 HBuilderX 做原生调试。
真机调试时同样注意 baseUrl 不能是 localhost。
继续读
- [打包发布](/docs/wujies/5.x/frontends/app/build)
- [小程序端](/docs/wujies/5.x/frontends/app/mp)
- [环境与接口配置](/docs/wujies/5.x/frontends/h5/config)
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-78a20d9a1c2d-guide.svg)


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