- 落地手机端双形态适配框架:同名布局+资源限定符(layout/手机、 layout-sw600dp/平板)自动切换,DeviceUtil 设备形态判定,7个 手机版公共组件(PhoneSearchBar/StatusTab/DataLayout/FilterPanel/ BottomBar/StatBox/KvItem) - 完成「国际出港移库」「国际出港出库交接」两页手机端适配,新增 各自详情页(IntExpMoveDetailActivity/IntExpOutHandoverDetailActivity) - 手机端首页菜单接入"出港移库""出库交接"入口 - 修复手机端进入页面先横屏后转竖屏的闪屏问题:Manifest 全项目 192 处改为 screenOrientation="unspecified",由 BaseActivity 按设备形态运行时锁定方向 - 修复该方案的中间版本在平板端引入的回归(先竖后横 + UI放大1.6倍) - AutoSize 补充手机竖屏 390×844 设计基准 - 修复 CHANGELOG.md 因脚本异常导致的内容重复损坏(膨胀至12万行), 恢复正常结构并补充本次变更记录 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
5.5 寸手持端适配 —— 后端接口补充清单
适配手机端时,设计稿要求展示/筛选的部分内容,现有接口没有提供或未生效。 以下为实机联调(内网真实数据)验证过的结论,客户端侧已按设计稿把 UI 与参数都做好, 后端补齐后即可直接生效,客户端基本无需再改。
整理时间:2026-07-29 验证环境:内网 192.168.1.250:8093,账号 ADMIN
一、参数已发送但后端未生效(客户端已就绪,等后端支持)
| 接口 | 参数 | 用途 | 实测现象 |
|---|---|---|---|
IntExpOutHandover/pageQueryIntExpOutHandover/pageQueryTotal |
hoState("0" 待交接 / "1" 已交接) |
出库交接页「待交接 / 已交接」Tab 过滤与角标计数 | 请求体确认携带 "hoState":"0" / "1",但两个 Tab 返回完全相同的数据;pageQueryTotal 的 wbNumber 也不随之变化 |
IntExpMove/pageQueryIntExpMove/pageQueryTotal |
spCode(特码,如 "PER") |
出港移库页筛选弹层「特码」 | 请求体确认携带 "spCode":"PER",但返回结果中仍含特码为 PEF 的记录,角标计数也无变化 |
对照参考:同一接口的
moveState、by1(承运人)、awbType(运单类型)均正常生效 (实测承运人填 MU 后待移库数量 67 → 60),因此可以排除客户端传参方式的问题。若贵方使用的参数名与上表不同,请告知正确名称,客户端改一处常量即可。
二、接口未返回、设计稿需要展示的字段
以下字段目前接口完全不返回,或恒为 null。客户端已按设计稿保留完整 UI 结构,
数据为空时统一占位 -,后端补齐后自动显示。
2.1 IntExpMove/pageQuery(出港移库)
| 设计稿位置 | 需要的字段 | 当前状况 |
|---|---|---|
| 列表卡片第二行「航班信息:20260709/MU2311」 | 航班日期 + 航班号(如 fdate / fno) |
接口无任何航班相关字段 |
| 详情页「移库信息」卡片 —— 移库人 | 移库人姓名(现只有 opId) |
opId 恒为 null,且即便有值也是 ID 而非姓名 |
| 详情页「移库信息」卡片 —— 移库时间 | opdate |
恒为 null,已移库记录也是 null |
| 详情页蓝色表头右侧时间戳 | 同上 opdate |
同上 |
| 详情页类型行右侧「普通货物运输」 | businessType 或 cargoType |
两者均恒为 null |
2.2 说明
- 出库交接页的详情所需字段(板型、库位、复磅人/时间等)接口均已返回,无需补充。
- 移库详情页红色标签绑的是
awbTypeName(真实值形如「国际出港(国际直航)」),已正常。 设计稿上写的「国际进港」经判断为设计稿笔误(该页属国际出港),未按字面实现。
三、附:字典接口调用口径(客户端已按此对齐,仅作备忘)
typeCode/getSpecialCodeByParam(特码字典):
flag=1(国际)+ieFlag=""(留空)→ 正常返回 RXE/PER/PEM/PEF/LDP/GJJ/DGR 等flag=1+ieFlag="E"→ 返回"data": []空数组
国际出港各页面统一使用 ieFlag=""。如该行为非预期,请后端确认 ieFlag 的取值约定。