feat: 完成国际出港移库/出库交接页面5.5寸手机端适配
- 落地手机端双形态适配框架：同名布局+资源限定符（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>
This commit is contained in:
120
.claude/skills/phone-adapt/references/components.md
Normal file
120
.claude/skills/phone-adapt/references/components.md
Normal file
@@ -0,0 +1,120 @@
|
||||
# 手机版公共组件（`module_base/.../ui/weight/phone/`）
|
||||
|
||||
7 个组件覆盖设计稿反复出现的部件。**先复用，实在没有再新增**——每个新组件都要维护、都要踩一遍
|
||||
状态恢复的坑，能少一个是一个。
|
||||
|
||||
所有属性都是**无命名空间写法**（与平板端 `PadSearchLayout` 一致），DataBinding 适配器集中在
|
||||
`PhoneWidgetKtx.kt`。同名属性（`hint`/`value`/`title`/`list`）按控件类型解析，与 Pad 系组件不冲突。
|
||||
|
||||
## 组件与属性
|
||||
|
||||
| 组件 | 用途 | 属性 |
|
||||
|------|------|------|
|
||||
| `PhoneSearchBar` | 顶部搜索行：搜索框 + 扫码 + 圆形筛选按钮 | `hint`、`value`(双向)、`showScan`、`showFilter`、`upperCase`、`setOnScanClickListener`、`setOnFilterClickListener`、`setRefreshCallBack` |
|
||||
| `PhoneStatusTab` | 状态 Tab 条（文字 + 角标 + 选中下划线） | `tabs`(List\<KeyValue\>)、`counts`(List\<String\>)、`value`(双向)、`setOnTabChanged` |
|
||||
| `PhoneDataLayout` | 表单/筛选项，三形态 | `title`、`hint`、`type`(`PhoneDataLayoutType.INPUT`/`DATE`/`SPINNER`)、`value`(双向)、`list`、`required`、`enable`、`setRefreshCallBack` |
|
||||
| `PhoneFilterPanel` | 底部筛选弹层（遮罩 + 面板 + 重置/确认） | `title`、`panelVisible`、`setOnResetClick`、`setOnConfirmClick`、`setOnDismissClick` |
|
||||
| `PhoneBottomBar` | 底部操作条（全选 + 已选统计 + 主按钮） | `allChecked`、`countText`、`actionText`、`setOnAllCheckClick`、`setOnActionClick` |
|
||||
| `PhoneStatBox` | 卡片内 2~4 列统计框，未传 label 的列自动隐藏 | `label1..4`、`value1..4` |
|
||||
| `PhoneKvItem` | 详情页字段项（灰标签 + 数值） | `title`、`value`、`tag`(true → 橙色高亮标签) |
|
||||
|
||||
`KeyValue` 是 `dev.utils.app.info.KeyValue`，字段是 **`key`（显示文案）+ `value`（业务值）**，
|
||||
不是 `name`。`PhoneStatusTab` 的 `tabs` 就按 `KeyValue("待交接","0")` 传。
|
||||
|
||||
## PhoneFilterPanel 的内容插槽
|
||||
|
||||
筛选项直接写在标签内，组件 `onFinishInflate` 会自动把它们移进面板中部并施加 20dp 项间距，
|
||||
使用方不用关心内部层级、也不用逐个写 `marginTop`：
|
||||
|
||||
```xml
|
||||
<com.lukouguoji.module_base.ui.weight.phone.PhoneFilterPanel
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="match_parent"
|
||||
title='@{"筛选条件"}'
|
||||
panelVisible="@{activity.filterPanelVisible}"
|
||||
setOnResetClick="@{(v)-> activity.resetFilter()}"
|
||||
setOnConfirmClick="@{(v)-> activity.confirmFilter()}"
|
||||
setOnDismissClick="@{(v)-> activity.toggleFilterPanel()}">
|
||||
|
||||
<com.lukouguoji.module_base.ui.weight.phone.PhoneDataLayout
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="wrap_content"
|
||||
title='@{"航班日期"}' hint='@{"请选择航班日期"}'
|
||||
type="@{PhoneDataLayoutType.DATE}" value="@={viewModel.flightDate}" />
|
||||
|
||||
</com.lukouguoji.module_base.ui.weight.phone.PhoneFilterPanel>
|
||||
```
|
||||
|
||||
记得在 `<data>` 里 `<import type="com.lukouguoji.module_base.ui.weight.phone.PhoneDataLayoutType" />`。
|
||||
|
||||
## ⚠️ 新增复合组件必做：屏蔽子控件状态恢复
|
||||
|
||||
同一页面放多个同类组件时（比如筛选弹层里 3 个 `PhoneDataLayout`），它们的内部子控件
|
||||
（`et`/`tv`/`spinner`…）**共用同一套 id**。系统按 id 保存/恢复视图状态会跨实例串档。
|
||||
|
||||
实际后果（出库交接踩过）：DATE 项的默认日期被邻近输入框恢复的空文本覆盖，
|
||||
`EditText.setText("")` 触发 `doOnTextChanged`，再经双向绑定把 ViewModel 的航班日期也写成空——
|
||||
**筛选条件静默丢失，界面上只表现为"日期没了"，极难联想到状态恢复**。
|
||||
|
||||
所以每个含内部 id 的组件都要写：
|
||||
|
||||
```kotlin
|
||||
override fun dispatchSaveInstanceState(container: SparseArray<Parcelable>) =
|
||||
dispatchFreezeSelfOnly(container)
|
||||
|
||||
override fun dispatchRestoreInstanceState(container: SparseArray<Parcelable>) =
|
||||
dispatchThawSelfOnly(container)
|
||||
```
|
||||
|
||||
取值本来就由 ViewModel + DataBinding 持有，不需要视图级恢复，屏蔽掉没有副作用。
|
||||
|
||||
配套的第二道防线：多形态组件里，文本回写要限定形态，别让隐藏控件影响取值：
|
||||
|
||||
```kotlin
|
||||
et.doOnTextChanged { text, _, _, _ ->
|
||||
if (type == PhoneDataLayoutType.INPUT) value = text.toString()
|
||||
}
|
||||
```
|
||||
|
||||
### 遇到"值被神秘清空"怎么定位
|
||||
|
||||
在 setter 里打一条带堆栈的日志，一次就能看到真凶：
|
||||
|
||||
```kotlin
|
||||
android.util.Log.d("DBG", "value '$field' -> '$v'", Throwable("trace"))
|
||||
```
|
||||
|
||||
出库交接那次的栈是 `TextView.onRestoreInstanceState → EditText.setText → doOnTextChanged`，
|
||||
指向非常明确。**排完记得删日志。**
|
||||
|
||||
## 新增组件的写法约定
|
||||
|
||||
照现有 7 个组件的模式来，保持一致：
|
||||
|
||||
1. 继承 `LinearLayout`/`FrameLayout`，`init` 里 `inflate(context, R.layout.layout_phone_xxx, this)`
|
||||
2. 内部布局用 `<merge tools:parentTag="android.widget.LinearLayout">`，避免多一层嵌套
|
||||
3. 属性做成 Kotlin `var` + setter 里立即生效；双向绑定值用
|
||||
`onChangeListener: InverseBindingListener?`
|
||||
4. BindingAdapter 统一加到 `PhoneWidgetKtx.kt`，函数名带组件名前缀避免顶层函数重名
|
||||
5. 有互斥形态时，**`type` 要先于 `value` 生效**（把 type 放进同一个多属性 adapter 的第一个
|
||||
`?.let`），否则 value 会写进错误的子控件
|
||||
6. 加上上面那两个 `dispatch*SelfOnly` 覆写
|
||||
7. 完成后同步更新 `CLAUDE.md` 的组件表和记忆文件 `phone-5.5inch-adaptation.md`
|
||||
|
||||
## 资源
|
||||
|
||||
配色一律用 `phone_*`，背景用 `bg_phone_*`，图标用 `ic_phone_*`，禁止写死色值。
|
||||
已有的（不够再加，加完更新 CLAUDE.md）：
|
||||
|
||||
- 色：`phone_primary` `phone_page_bg` `phone_bg` `phone_stat_bg` `phone_text_title/body/hint/label/strong/weak_btn`
|
||||
`phone_divider` `phone_badge_bg` `phone_green` `phone_check_border` `phone_tag_gray_*` `phone_tag_green_*`
|
||||
`phone_tag_red_*` `phone_orange_bg/text`
|
||||
- 背景：`bg_phone_card` `bg_phone_search` `bg_phone_input` `bg_phone_stat_box` `bg_phone_panel_top`
|
||||
`bg_phone_icon_round` `bg_phone_btn_primary` `bg_phone_btn_outline` `bg_phone_badge`
|
||||
`bg_phone_tag_green/gray/red/orange` `bg_phone_card_header_blue/green`
|
||||
- 图标：`ic_phone_airplane` `ic_phone_location` `ic_phone_person` `ic_phone_check_circle`
|
||||
`ic_phone_chevron_right/down` `ic_phone_calendar` `ic_phone_close`
|
||||
`ic_phone_check_round_checked/unchecked`（圆形复选框）
|
||||
- 复用 Pad 的矢量图：`img_search` `img_scan` `img_filter`（可 `app:tint` 染色）
|
||||
|
||||
设计稿里的 MDI 图标若缺失，直接写 24×24 的 vector（用 MDI 官方 path），比找位图靠谱且能染色。
|
||||
167
.claude/skills/phone-adapt/references/pad-safety.md
Normal file
167
.claude/skills/phone-adapt/references/pad-safety.md
Normal file
@@ -0,0 +1,167 @@
|
||||
# Pad 端零破坏 & 易崩点
|
||||
|
||||
平板端是在跑的生产功能，适配手机不能改变它的任何行为。以下是必须遵守的约束和踩过的坑。
|
||||
|
||||
## 布局变体的三条硬约束
|
||||
|
||||
同名布局 + 资源限定符（`layout/` 手机 / `layout-sw600dp/` 平板）会让 DataBinding 生成
|
||||
**一个 Binding 基类 + 两个变体实现**，因此 Kotlin 侧零改动。代价是两个变体必须兼容：
|
||||
|
||||
### 1. `<variable>` 必须完全一致
|
||||
|
||||
手机变体需要 `activity` 变量（暴露纯 UI 方法给 XML）时，**平板变体也要补上**，否则编译报
|
||||
`variable not found`。平板不用它，加个注释说明即可：
|
||||
|
||||
```xml
|
||||
<!-- 平板端不使用，仅为与手机变体保持变量一致 -->
|
||||
<variable name="activity" type="com.lukouguoji.gjc.activity.XxxActivity" />
|
||||
```
|
||||
|
||||
### 2. 共用 id 双方都要保留
|
||||
|
||||
Activity / ViewHolder 引用到的 id（`srl`、`rv`、`iv_icon`、`checkIcon`…）两个变体都要有。
|
||||
可以换位置换样式，但 id 得在。
|
||||
|
||||
### 3. 单侧独有的 id 会变 `@Nullable`
|
||||
|
||||
只在手机变体存在的 id（如「查看详情」的 `ll_detail`），Binding 基类里是可空字段，
|
||||
Kotlin 侧必须判空：
|
||||
|
||||
```kotlin
|
||||
// 平板变体没有这个控件，为 null 时直接跳过
|
||||
binding.llDetail?.setOnClickListener { XxxDetailActivity.start(itemView.context, bean) }
|
||||
```
|
||||
|
||||
编译器会强制你处理，不用担心漏掉。改完可以核对生成代码确认：
|
||||
|
||||
```bash
|
||||
grep -B3 "llDetail" module_gjc/build/generated/data_binding_base_class_source_out/debug/out/\
|
||||
com/lukouguoji/gjc/databinding/ItemXxxBinding.java
|
||||
```
|
||||
|
||||
### ⛔ 绝对不要用「不同文件名 + 代码判断」切布局
|
||||
|
||||
`activity_xxx_phone.xml` 会生成 `ActivityXxxPhoneBinding`，而字段声明的类型是
|
||||
`ActivityXxxBinding`。泛型擦除让**编译期查不出来**，一进页面就 `ClassCastException`。
|
||||
|
||||
## 业务层零破坏的三个模式
|
||||
|
||||
### 新增查询维度：默认空值 + 仅非空进请求
|
||||
|
||||
平板布局没有对应控件 → 字段恒为空 → 不进请求体 → 平板查询与改造前逐字节一致。
|
||||
|
||||
```kotlin
|
||||
val handoverState = MutableLiveData("") // 手机 Tab 绑这个，平板无控件
|
||||
val hoId = MutableLiveData("")
|
||||
|
||||
val filterParams = mapOf(
|
||||
"fdate" to flightDate.value?.ifEmpty { null },
|
||||
/* 原有字段… */
|
||||
"hoState" to handoverState.value?.ifEmpty { null }, // 空 → null → 不影响平板
|
||||
"hoId" to hoId.value?.ifEmpty { null },
|
||||
)
|
||||
```
|
||||
|
||||
### 手机专属的额外请求：ViewModel 内部开关
|
||||
|
||||
Tab 角标计数、新增下拉字典这类请求，平板不需要，多发就是改变了平板行为（请求次数）。
|
||||
用一个内部布尔控制，由 Activity 在手机形态下开启：
|
||||
|
||||
```kotlin
|
||||
// ViewModel
|
||||
private var phoneExtrasEnabled = false
|
||||
|
||||
fun initPhoneExtras() {
|
||||
phoneExtrasEnabled = true
|
||||
handoverState.value = "0" // 手机默认停在第一个 Tab
|
||||
DictUtils.getWHSUserList(addAll = false) { hoUserList.postValue(it) }
|
||||
}
|
||||
|
||||
override fun getData() {
|
||||
/* 原有列表 + 统计请求… */
|
||||
if (phoneExtrasEnabled) loadTabCounts(filterParams) // 平板不触发
|
||||
}
|
||||
```
|
||||
|
||||
```kotlin
|
||||
// Activity
|
||||
if (DeviceUtil.isPhone()) viewModel.initPhoneExtras()
|
||||
```
|
||||
|
||||
`DeviceUtil.isPhone()` 只用来决定**数据默认值和额外请求**，**永远不用来选布局**。
|
||||
|
||||
### 纯 UI 状态放 Activity
|
||||
|
||||
弹层显隐、Tab 高亮这类与业务无关的状态，用 `ObservableBoolean` 放在 Activity 上暴露给 XML，
|
||||
不要污染 ViewModel：
|
||||
|
||||
```kotlin
|
||||
val filterPanelVisible = ObservableBoolean(false)
|
||||
fun toggleFilterPanel() = filterPanelVisible.set(!filterPanelVisible.get())
|
||||
```
|
||||
|
||||
### 同名 id 在两个变体里必须是同一种控件
|
||||
|
||||
平板变体的 `btnMove` 是 `TextView`，手机版底部换成了 `PhoneBottomBar`——**不要为了复用
|
||||
Activity 里的 `binding.btnMove` 而把这个 id 安到 PhoneBottomBar 上**。同名不同类型会让
|
||||
DataBinding 把字段类型退化成公共父类，编译期未必报错，运行时行为难料。
|
||||
|
||||
正确做法：手机端的按钮点击走组件自身的 `setOnActionClick`，`btnMove` 就只留在平板变体里，
|
||||
Activity 侧判空调用：
|
||||
|
||||
```kotlin
|
||||
binding.btnMove?.setOnClickListener { showMoveConfirmDialog() }
|
||||
```
|
||||
|
||||
被 XML 调用的 Activity 方法记得改成 public。
|
||||
|
||||
### 调字典要对齐既有页面的参数口径
|
||||
|
||||
`DictUtils` 的方法参数常有"看起来合理但后端不认"的取值。出港移库的特码下拉一开始传
|
||||
`ieFlag="E"`（出港），接口返回空数组；而同模块既有页面（`GjcWeighingStartViewModel` 等）
|
||||
一律传 `ieFlag=""`，能正常返回。
|
||||
|
||||
所以调字典前先 grep 一下同模块其他页面怎么调的，照抄它们的参数；改完必须在实机上
|
||||
**把下拉点开确认真的有数据**，空列表在 UI 上看不出报错。
|
||||
|
||||
### 共享方法别为手机改语义
|
||||
|
||||
`checkAllClick()` 这类平板也在用的方法，不要为了手机端的语义去改它。
|
||||
例：手机「待交接」Tab 下理论上只有未交接记录（服务端按状态过滤），所以全选照原样全量勾选就是对的；
|
||||
若为此加上「跳过已交接」的过滤，反而改变了平板端（平板列表混排两种状态）的行为。
|
||||
|
||||
## 屏幕方向：Manifest 必须写资源引用
|
||||
|
||||
新增 Activity 注册时：
|
||||
|
||||
```xml
|
||||
<activity android:name="…"
|
||||
android:configChanges="orientation|keyboardHidden"
|
||||
android:exported="false"
|
||||
android:screenOrientation="@integer/screen_orientation" />
|
||||
```
|
||||
|
||||
**不要写死 `userLandscape`。** `screenOrientation` 由系统在创建 Activity 窗口时生效，
|
||||
那时业务代码还没跑；写死横屏后即使 `BaseActivity` 在 `super.onCreate` 之前改成竖屏，
|
||||
用户也会看到「先横屏、约 1 秒后转竖屏」的闪屏和重建。
|
||||
|
||||
资源取值：`module_base/res/values/integers.xml` = 1(portrait)，
|
||||
`values-sw600dp/integers.xml` = 11(userLandscape)。全项目已统一替换。
|
||||
|
||||
## 改 module_base 公共代码时
|
||||
|
||||
`module_base` 被所有业务模块依赖，改动会影响全部页面。原则：
|
||||
|
||||
- **只做增量**：加新组件、新颜色、新 drawable，别改既有组件的行为
|
||||
- 确实要改公共基类（`BaseActivity` / `BaseBindingActivity` / Pad 系组件）时，
|
||||
**必须在平板上回归**至少 2~3 个不同类型的既有页面
|
||||
- Bean 上加只读计算属性是安全的（Gson 只序列化字段，不动 getter）；
|
||||
加**字段**要谨慎，会进请求体
|
||||
|
||||
## 已知的既有问题（不是你改坏的）
|
||||
|
||||
用 `am start` 直启页面时，若**先经过首页**再启目标页，会崩在
|
||||
`LoadingModel.showLoading` → XPopup `popupInfo is null`。在**未改动**的页面上同样复现，
|
||||
属于既有缺陷。**冷启动直启不受影响**（`force-stop` 后直接 `am start`）。
|
||||
|
||||
遇到崩溃先做这个对照实验再下结论：拿一个你没碰过的页面用同样方式打开，看是否同样崩。
|
||||
166
.claude/skills/phone-adapt/references/verification.md
Normal file
166
.claude/skills/phone-adapt/references/verification.md
Normal file
@@ -0,0 +1,166 @@
|
||||
# 端到端验证手册
|
||||
|
||||
目标：在**真实接口**下把手机端走通，并确认平板端没退化。只看编译通过是不够的——
|
||||
本次适配里"筛选条件被静默清空"和"后端不认新参数"两个问题，都只有跑真机才暴露。
|
||||
|
||||
## 环境
|
||||
|
||||
```bash
|
||||
~/Library/Android/sdk/emulator/emulator -list-avds # Medium_Phone_API_36.1(手机) / Aerologic_Tablet(平板)
|
||||
adb devices -l
|
||||
adb -s <serial> shell wm size && adb -s <serial> shell wm density
|
||||
```
|
||||
|
||||
判定形态：手机 1080×2400@420dpi → `PHONE(sw=411dp)`；平板 1280×800@160dpi → `TABLET(sw=800dp)`。
|
||||
|
||||
`ui_probe.sh` 封装了常用操作，比手写 adb 省事且更可靠：
|
||||
|
||||
```bash
|
||||
P=.claude/skills/phone-adapt/scripts/ui_probe.sh
|
||||
$P <serial> form # 打印形态识别结果
|
||||
$P <serial> texts # 当前界面所有可见文字（做断言用）
|
||||
$P <serial> bounds "已交接" # 元素 bounds + 中心点
|
||||
$P <serial> tap-text "确认" # 按文字点击（自动取中心点）
|
||||
$P <serial> wait-text "待交接" # 等页面就绪
|
||||
$P <serial> wait-gone "请稍候……" # 等加载弹窗消失
|
||||
$P <serial> shot /tmp/a.png # 截图
|
||||
$P <serial> req pageQuery # 抓请求/响应体
|
||||
$P <serial> crash # 崩溃次数 + 栈
|
||||
```
|
||||
|
||||
## 构建安装
|
||||
|
||||
```bash
|
||||
./gradlew assembleDebug 2>&1 | grep -E "^(BUILD|FAILURE)|error:"
|
||||
adb -s <serial> install -r -d app/build/outputs/apk/debug/app-debug.apk
|
||||
```
|
||||
|
||||
注意 gradle 输出里大量 `e: 注: ARouter::Compiler …` 是注解处理器的**提示**被误标成 `e:`，
|
||||
不是错误；只看 `BUILD SUCCESSFUL` / `error:` 就行。
|
||||
|
||||
## 进入目标页面的两条路
|
||||
|
||||
### 正规路径（优先）：登录 → 首页菜单
|
||||
|
||||
```bash
|
||||
adb -s <serial> shell monkey -p com.lukouguoji.aerologic -c android.intent.category.LAUNCHER 1
|
||||
```
|
||||
|
||||
登录页账号密码需要用户提供。填表用 `input text`，注意 `#` 等字符要转义（`Aa123456\#`）。
|
||||
底部有「首页 / 国内 / 国际 / 我的」Tab，国际业务页找对应入口。
|
||||
|
||||
**首页菜单是按权限过滤的**：当前账号角色没有该权限时，入口根本不显示（本次 ADMIN 登录后
|
||||
国际业务只有「板箱过磅」「进港理货」，没有「出库交接」）。这时走下面的直启。
|
||||
|
||||
### 直启（权限缺失时的替代）：冷启动 + am start
|
||||
|
||||
`app/src/debug/AndroidManifest.xml` 里把调试页临时 `exported="true"`，就能直接拉起。
|
||||
**必须冷启动**（先 force-stop），否则会撞上既有的 LoadingModel 崩溃：
|
||||
|
||||
```bash
|
||||
adb -s <serial> shell am force-stop com.lukouguoji.aerologic
|
||||
sleep 2
|
||||
adb -s <serial> shell am start -n com.lukouguoji.aerologic/<完整类名>
|
||||
```
|
||||
|
||||
登录态存在 SharedPreference 里，冷启动直启同样带 token，接口能正常返回真实数据。
|
||||
|
||||
> 先经首页再 `am start` 会崩在 `LoadingModel.showLoading` → XPopup `popupInfo is null`，
|
||||
> 这是既有缺陷（未改动的页面也复现），不是本次改动引入的。
|
||||
|
||||
## 点击前先等就绪
|
||||
|
||||
加载弹窗（"请稍候……"）会盖住整屏并**吞掉 `input tap`**，表现为"点了没反应"。
|
||||
本次验证就因此白跑了几轮。所以：
|
||||
|
||||
```bash
|
||||
$P <serial> wait-text "待交接" # 等目标元素出现
|
||||
$P <serial> tap-text "已交接"
|
||||
$P <serial> texts | grep -c "全选" # 用文字变化确认点击确实生效
|
||||
```
|
||||
|
||||
点完**一定要断言效果**（用 `texts` 或截图），别假设点中了。
|
||||
|
||||
## 逐项走查清单
|
||||
|
||||
每一步做完都跑一次 `crash`（必须为 0）：
|
||||
|
||||
- [ ] 列表加载：卡片字段、各种状态形态（如待处理 / 已完成两种卡片）
|
||||
- [ ] Tab 切换：指示条位置、角标数字、底部条按设计显隐
|
||||
- [ ] 筛选弹层：打开、各控件取值、重置、确认后重新查询
|
||||
- [ ] 下拉字典：真实取到数据（不是空列表）
|
||||
- [ ] 多选：单选、全选联动、"已选 N 项"计数
|
||||
- [ ] 详情页/二级页：字段绑定、条件显示的区块
|
||||
- [ ] 扫码入口能拉起
|
||||
|
||||
## 核对请求参数是否真的生效
|
||||
|
||||
新增的查询字段要确认两件事：客户端**发出去了**，服务端**认**。
|
||||
|
||||
```bash
|
||||
$P <serial> req pageQuery
|
||||
```
|
||||
|
||||
OkHttp 日志是多行 pretty JSON。看到请求体里有你的字段（如 `"hoState": "0"`）只说明客户端对了。
|
||||
**服务端是否生效要用行为验证**：切到另一个 Tab，看返回数据是否真的变了。
|
||||
|
||||
本次实测：请求正确携带 `hoState:"0"/"1"`，但两个 Tab 返回同一批数据 → 后端没做过滤。
|
||||
这种情况**必须在交付说明里如实标注**，不能让它看起来是通的。
|
||||
|
||||
## 无数据时怎么核对 UI
|
||||
|
||||
服务端当天可能没数据（列表空）。放宽条件（清空日期）再查；仍为空时，临时注入样例 Bean：
|
||||
|
||||
```kotlin
|
||||
// 临时：覆盖各种形态各一条，验证后删除
|
||||
binding.rv.postDelayed({
|
||||
binding.rv.commonAdapter()?.refresh(listOf(/* 待处理 / 危险品 / 已完成 各一条 */))
|
||||
}, 2500)
|
||||
```
|
||||
|
||||
截图核对完**必须删除**，然后重新构建 + grep 确认无残留：
|
||||
|
||||
```bash
|
||||
grep -rn "injectMockForVisualCheck\|TODO 临时" module_base/src module_gjc/src | wc -l # 应为 0
|
||||
```
|
||||
|
||||
## 屏幕方向验证
|
||||
|
||||
新增/修改 Activity 后，确认手机端不会「先横屏再转竖屏」：
|
||||
|
||||
```bash
|
||||
# 冷启动时连续采样：应全程 mRotation=0
|
||||
adb -s <phone> shell am force-stop com.lukouguoji.aerologic; sleep 2
|
||||
adb -s <phone> shell monkey -p com.lukouguoji.aerologic -c android.intent.category.LAUNCHER 1
|
||||
for i in $(seq 1 10); do adb -s <phone> shell dumpsys window | grep -m1 -oE "mRotation=[0-9]+"; sleep 0.4; done
|
||||
```
|
||||
|
||||
平板则应首屏就是横屏（截图宽 > 高）。若手机出现横屏帧，检查该 Activity 的 Manifest
|
||||
是否漏写 `android:screenOrientation="@integer/screen_orientation"`。
|
||||
|
||||
## Pad 端回归（必做）
|
||||
|
||||
```bash
|
||||
adb -s <tablet> install -r -d app/build/outputs/apk/debug/app-debug.apk
|
||||
adb -s <tablet> shell am start -n com.lukouguoji.aerologic/<同一个类名>
|
||||
$P <tablet> shot /tmp/tablet.png
|
||||
$P <tablet> form # 应为 TABLET(sw=800dp…)
|
||||
```
|
||||
|
||||
对比改造前后：搜索条数量与顺序、日期默认值、按钮（平板可能比手机多按钮）、底部统计文案。
|
||||
改过 `module_base` 里的公共基类或 Pad 系组件时，这一步不能省，且要多看几个页面。
|
||||
|
||||
## 定位"值被神秘修改"类问题
|
||||
|
||||
在 setter 里打带堆栈的日志，一次就能看到调用来源：
|
||||
|
||||
```kotlin
|
||||
android.util.Log.d("DBG", "value '$field' -> '$v'", Throwable("trace"))
|
||||
```
|
||||
|
||||
```bash
|
||||
adb -s <serial> logcat -d -s DBG | grep -A14 "'旧值' -> ''" | grep "at com.lukouguoji\|at android"
|
||||
```
|
||||
|
||||
本次靠这招定位到 `TextView.onRestoreInstanceState → EditText.setText → doOnTextChanged`，
|
||||
即复合自定义 View 的 id 串档（见 `components.md`）。**排完删日志。**
|
||||
Reference in New Issue
Block a user