133 lines
4.1 KiB
Markdown
133 lines
4.1 KiB
Markdown
# 风影随行通讯 · 手机端交接（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 打开
|
||
|
||
1. 安装 [HBuilderX](https://www.dcloud.io/hbuilderx.html)（正式版）
|
||
2. 登录 DCloud 账号（云打包要用）
|
||
3. **文件 → 导入 → 从本地目录导入** → 选桌面上的 `fysx-hbuilder`
|
||
4. 若提示重新获取 `appid`，确定即可；应用名保持「风影随行通讯」
|
||
|
||
已导入过的，增量拉取后在 HBuilderX 里重新打开该目录即可，不必再导入一遍。
|
||
|
||
---
|
||
|
||
## 5. 开发 / 测试
|
||
|
||
**H5 快测：** 运行 → 运行到浏览器 → Chrome。现网账号登录。看登录、消息、工作台格子是否随权限变。H5 定位不准，打卡以真机为准。
|
||
|
||
**真机：** USB 开开发者选项 + 调试 → 运行到手机 → Android。打卡必须允许定位。
|
||
|
||
**换两个权限不同的人登录**，工作台格子应不一样。没「投标管理」的人不应看到投标入口。
|
||
|
||
---
|
||
|
||
## 6. 打包 APK
|
||
|
||
1. 发行 → 原生 App-云打包
|
||
2. Android，CPU 勾 `armeabi-v7a` + `arm64-v8a`
|
||
3. 证书：内测可用 DCloud 公共测试证书；上架再换自己的 keystore
|
||
4. 下载 APK 装到手机
|
||
|
||
打包产物在本机 `unpackage/`，增量拉取不会删它。
|
||
|
||
---
|
||
|
||
## 7. 什么时候才再碰 Linux
|
||
|
||
手机 UI / 打包：不用。
|
||
|
||
只有改后端接口、权限、IM 协议，或要把 APK 挂到现网下载页时才上服务器。
|
||
|
||
可选（Windows CMD，把打好的包挂现网）：
|
||
|
||
```bat
|
||
scp D:\你的包.apk root@47.96.23.244:/data/nexus-oa-erp/dist/downloads/android.apk
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 验收清单
|
||
|
||
1. 登录（短信码仅服务端开启时出现）
|
||
2. 消息列表：工作通知 / 群 / 单聊，能发文字
|
||
3. 换账号后工作台入口不同
|
||
4. 无模块权限时 ERP 页提示无权限
|
||
5. 真机打卡能提交
|
||
6. 待办、请假/报销能走现网审批
|
||
|
||
---
|
||
|
||
## 9. 桌面增量拉取（CMD）
|
||
|
||
在 **Windows CMD** 执行。会下载最新包并解压覆盖桌面上的 `fysx-hbuilder`（只覆盖包里有的文件）。
|
||
|
||
```bat
|
||
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`
|