Files
oa_app/交接.md
T
2026-09-23 16:52:48 +08:00

4.1 KiB
Raw Blame History

风影随行通讯 · 手机端交接(Windows)

手机端以后只在你这台 Windows 上改、测、打包。Linux 主机只跑现网 OA/IM,不再当手机开发机。

工程已在桌面时,用文末 CMD 增量拉取 覆盖服务器上的新文件即可,本地多出来的文件(例如 unpackage/、自己改过但服务器没有的)不会被删。


1. 分工

在哪 干什么
Windows + HBuilderX 改页面、联调、真机、打 APK
Linux / 现网 oa.fysxkj.com 后端、权限、IM。手机只调接口

现网地址(utils/config.js):

  • OAhttps://oa.fysxkj.com
  • IM HTTPhttps://oa.fysxkj.com/im
  • IM WSwss://oa.fysxkj.com/im/websocket

本地不用起后端、不用 npm、没有 node_modules


2. 权限(不要写死)

工作台入口只认 /auth/my-perms,和 Web 权限中心同一套。

  • 判断:utils/perms.jscanMenu
  • 目录(只描述「有这个权限才显示」):utils/catalog.js
  • 登录后拉权:utils/store.jsrefreshPerms()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(正式版)
  2. 登录 DCloud 账号(云打包要用)
  3. 文件 → 导入 → 从本地目录导入 → 选桌面上的 fysx-hbuilder
  4. 若提示重新获取 appid,确定即可;应用名保持「风影随行通讯」

已导入过的,增量拉取后在 HBuilderX 里重新打开该目录即可,不必再导入一遍。


5. 开发 / 测试

H5 快测: 运行 → 运行到浏览器 → Chrome。现网账号登录。看登录、消息、工作台格子是否随权限变。H5 定位不准,打卡以真机为准。

真机: USB 开开发者选项 + 调试 → 运行到手机 → Android。打卡必须允许定位。

换两个权限不同的人登录,工作台格子应不一样。没「投标管理」的人不应看到投标入口。


6. 打包 APK

  1. 发行 → 原生 App-云打包
  2. AndroidCPU 勾 armeabi-v7a + arm64-v8a
  3. 证书:内测可用 DCloud 公共测试证书;上架再换自己的 keystore
  4. 下载 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. 验收清单

  1. 登录(短信码仅服务端开启时出现)
  2. 消息列表:工作通知 / 群 / 单聊,能发文字
  3. 换账号后工作台入口不同
  4. 无模块权限时 ERP 页提示无权限
  5. 真机打卡能提交
  6. 待办、请假/报销能走现网审批

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