Blame view

泰额版/Food Labeling Management App UniApp/README.md 2.96 KB
59e51671   “wangming”   1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
  # Food Label System - uni-app 版
  
  基于 uni-app 的跨平台食品标签管理员工端应用,1:1 还原 React 版本 (Food Labeling Management App React) 的页面与交互。
  
  ## 支持平台
  
  - **App (iOS / Android)**(当前仅维护 App)
  - 其他端(H5、小程序)未再维护
  
  ## 技术栈
  
  - **框架**: uni-app + Vue 3 + TypeScript
  - **构建**: Vite
  - **国际化**: vue-i18n(中英双语)
  - **样式**: rpx 响应式 + 内联样式
  
  ## 功能页面
  
  | 页面 | 路径 | 说明 |
  |------|------|------|
  | 登录 | `/pages/login/login` | 邮箱密码登录、记住我 |
  | 选择店铺 | `/pages/store-select/store-select` | 选择工作门店 |
  | 仪表盘 | `/pages/index/index` | 今日统计、快捷操作 |
  | 标签 | `/pages/labels/labels` | 创建/历史 Tab、6 种标签类型 |
  | 选择食品 | `/pages/labels/food-select` | 按类别选择、搜索 |
  | 标签预览 | `/pages/labels/preview` | 预览、打印 |
  | 更多 | `/pages/more/more` | 入口菜单 |
  | 个人资料 | `/pages/more/profile` | 编辑资料 |
  | 打印机 | `/pages/more/printers` | 打印机列表 |
  | 工作地点 | `/pages/more/location` | 门店详情、切换店铺 |
  | 同步状态 | `/pages/more/sync` | 数据同步 |
  | 语言设置 | `/pages/more/language` | 中/英切换 |
  | 支持 | `/pages/more/support` | 联系方式、资源 |
  
  ## 快速开始
  
  ```bash
  # 安装依赖
  npm install
  
  # H5 开发
  npm run dev:h5
  
  # 微信小程序
  npm run dev:mp-weixin
  
  # 构建 H5
  npm run build:h5
  ```
  
  ## App 打包(避免「__uniappview.html 无法打开」)
  
  1. **先构建再打包**(必须):
     ```bash
     npm run build:app
     ```
     会生成 `dist/build/app-plus/` 并同步到 `unpackage/dist/build/app-plus/`
  
  2. **用 HBuilderX 云打包**
     - 用 HBuilderX 打开**本项目根目录**(含 `package.json`、`src` 的目录)。
     - 菜单:**发行****原生 App-云打包**,选 Android/iOS,按提示打包。
     - 不要用「制作自定义调试基座」再单独打正式包,否则安装包内可能缺少 www 内容。
  
  3. 若仍提示「www/__uniappview.html 无法打开」:
     - 确认已执行过 `npm run build:app` 且无报错。
     - 确认是用 **发行 → 原生 App-云打包**,而不是自定义基座打包。
     - 用 HBuilderX 的「运行 → 运行到手机」先确认真机可正常打开,再云打包。
  
  ## 打印机
  
  - **Bluetooth**:在 Printer 页选 Bluetooth → Scan。Android 需开启**定位**权限才能扫到设备;无名称设备会显示为 "Unknown Device",可正常连接。
  - **Built-in(一体机)**:打印机与安卓一体、数据从本机下发时使用。依赖原生插件 `nativeplugins/moe-tcp-client`(已放入项目),通过 TCP 连接本机 9100 端口。打包时用 HBuilderX 云打包即可带上该插件。
  
  ## 设计规范(与 React 版一致)
  
  - 主色: #1F3A8A (Enterprise Blue)
  - 最大宽度: 480px (约 960rpx)
  - 底部导航: Dashboard / Labels / More
  - 触控高度: ≥ 48px (96rpx)