4.1 KiB
4.1 KiB
风影随行通讯 · 手机端交接(Windows)
手机端以后只在你这台 Windows 上改、测、打包。Linux 主机只跑现网 OA/IM,不再当手机开发机。
工程已在桌面时,用文末 CMD 增量拉取 覆盖服务器上的新文件即可,本地多出来的文件(例如 unpackage/、自己改过但服务器没有的)不会被删。
1. 分工
| 在哪 | 干什么 |
|---|---|
| Windows + HBuilderX | 改页面、联调、真机、打 APK |
| Linux / 现网 | oa.fysxkj.com 后端、权限、IM。手机只调接口 |
现网地址(utils/config.js):
- OA:
https://oa.fysxkj.com - IM HTTP:
https://oa.fysxkj.com/im - IM WS:
wss://oa.fysxkj.com/im/websocket
本地不用起后端、不用 npm、没有 node_modules。
2. 权限(不要写死)
工作台入口只认 /auth/my-perms,和 Web 权限中心同一套。
- 判断:
utils/perms.js的canMenu - 目录(只描述「有这个权限才显示」):
utils/catalog.js - 登录后拉权:
utils/store.js→refreshPerms()→personalApps()/erpModules()
谁看见打卡、审批、投标、人事,只由 Web 给这个人开的格子决定。不要按人名、岗位写死。
3. 工程结构
fysx-hbuilder/
pages.json 路由 / 底栏
manifest.json HBuilder 打包配置
App.vue / main.js
pages/ 页面(登录、消息、通讯录、打卡、工作台、我、聊天、审批、协同、ERP…)
utils/ 接口、权限、IM、申请单
components/ 顶栏
static/tab/ 底栏图标
交接.md 本文件
常改:
| 文件 | 作用 |
|---|---|
pages/tabs/workbench.vue |
工作台(权限过滤后的格子) |
pages/login/login.vue |
登录 |
utils/store.js |
会话、IM、打卡、审批 |
utils/api.js |
HTTP |
utils/im.js |
WebSocket |
utils/catalog.js |
工作台/ERP 入口元数据 |
utils/perms.js |
权限判断 |
utils/config.js |
现网地址 |
4. HBuilderX 打开
- 安装 HBuilderX(正式版)
- 登录 DCloud 账号(云打包要用)
- 文件 → 导入 → 从本地目录导入 → 选桌面上的
fysx-hbuilder - 若提示重新获取
appid,确定即可;应用名保持「风影随行通讯」
已导入过的,增量拉取后在 HBuilderX 里重新打开该目录即可,不必再导入一遍。
5. 开发 / 测试
H5 快测: 运行 → 运行到浏览器 → Chrome。现网账号登录。看登录、消息、工作台格子是否随权限变。H5 定位不准,打卡以真机为准。
真机: USB 开开发者选项 + 调试 → 运行到手机 → Android。打卡必须允许定位。
换两个权限不同的人登录,工作台格子应不一样。没「投标管理」的人不应看到投标入口。
6. 打包 APK
- 发行 → 原生 App-云打包
- Android,CPU 勾
armeabi-v7a+arm64-v8a - 证书:内测可用 DCloud 公共测试证书;上架再换自己的 keystore
- 下载 APK 装到手机
打包产物在本机 unpackage/,增量拉取不会删它。
7. 什么时候才再碰 Linux
手机 UI / 打包:不用。
只有改后端接口、权限、IM 协议,或要把 APK 挂到现网下载页时才上服务器。
可选(Windows CMD,把打好的包挂现网):
scp D:\你的包.apk root@47.96.23.244:/data/nexus-oa-erp/dist/downloads/android.apk
8. 验收清单
- 登录(短信码仅服务端开启时出现)
- 消息列表:工作通知 / 群 / 单聊,能发文字
- 换账号后工作台入口不同
- 无模块权限时 ERP 页提示无权限
- 真机打卡能提交
- 待办、请假/报销能走现网审批
9. 桌面增量拉取(CMD)
在 Windows CMD 执行。会下载最新包并解压覆盖桌面上的 fysx-hbuilder(只覆盖包里有的文件)。
cd /d %USERPROFILE%\Desktop && curl -L -o fysx-hbuilder.zip https://oa.fysxkj.com/downloads/fysx-hbuilder.zip && tar -xf fysx-hbuilder.zip
拉完打开:%USERPROFILE%\Desktop\fysx-hbuilder