中国 帮助

App 端

App 端和 H5、小程序共用 wujiesuniapp/ 的同一套页面代码,区别在运行容器、原生能力和打包流程。 工程目录:wujiesuniapp/ 应用标识:src/manifest.json 的 appid 版本号:vers

App 端
封面

> 本文整理自平台文档 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容