3.0 KiB
3.0 KiB
功能镜片配镜系统 - UniApp 移动端
基于 developer-front 门户端的 UniApp 实现,覆盖认证、配片单/制片单、消息通知、账户中心等核心业务。
项目结构
uniapp/
├── src/
│ ├── api/ # 接口封装
│ ├── components/ # NavBar、DictTag
│ ├── config/ # API 配置
│ ├── pages/ # 页面
│ ├── store/ # Pinia 状态
│ ├── utils/ # 工具函数
│ ├── App.vue
│ ├── main.js
│ ├── pages.json
│ └── manifest.json
├── index.html
├── vite.config.js
└── package.json
快速开始
cd uniapp
npm install
npm run dev:h5
默认端口 2093,API 代理至 http://localhost:8082/dev-api。
与 developer-front 的对应关系
| Web 端 | UniApp |
|---|---|
| Cookie Developer-Token | uni.setStorageSync |
| axios + Element UI | uni.request + 原生组件 |
| vue-router | pages.json |
| Vuex | Pinia |
| NavBar.vue | components/NavBar |
| lens-order.vue | pages/order/lens-order |
| factory-order.vue | pages/order/factory-order |
Android 编译器/SDK 版本不匹配
若 APK 提示「HBuilderX 4.15 编译,SDK 5.07 不匹配」:
- 原因: CLI 项目编译器在
package.json,不随 HBuilderX 升级;云打包 SDK 已是 5.x。 - 处理: HBuilderX 升级到 5.07 → 执行
npm run update:uni→npm install→ 删除unpackage→ 重新云打包。 - 验证后可选:
manifest.json的app-plus.compatible.ignoreVersion设为true关闭弹窗。
APK 卡在 Logo 启动页
- 已在
App.vue中调用plus.navigator.closeSplashscreen()手动关闭启动页 - CLI 构建产物里
autoclose可能为false,需重新云打包 - adb 包名过滤错误:AppID 为
__UNI__C17C074,应使用:adb logcat -c adb logcat | findstr /i "UNIC17C074 DCloud console uni-app JS" adb logcat *:E | findstr /i "uni dcloud" - 查看已安装包名:
adb shell pm list packages | findstr uni
AppID 配置(打包 Android/iOS 必做)
CLI 创建的项目不会自动生成 AppID,需在 HBuilderX 中获取并写入 src/manifest.json:
- 安装 HBuilderX,使用 DCloud 账号登录
- 文件 → 打开目录,选择本项目的
uniapp文件夹 - 打开
src/manifest.json,切换到 「基础配置」 可视化界面 - 点击 「应用标识(AppID)」 右侧的 「重新获取」
- 保存后,
appid会自动写入(格式类似__UNI__1A2B3C4)
也可在 DCloud 开发者中心 手动创建应用,将生成的 AppID 粘贴到 manifest.json 的 "appid" 字段。
AppID 与 DCloud 账号绑定,请勿使用他人 AppID 或随意编造(如
__UNI__OPTICAL_SYSTEM)。
待完善项
- 收货地址 CRUD
- 商城模块
- 配片单完整验光表单与附件上传
- 小程序/App 支付