Files
pacs_win_uia/tests/README.md
T
zimoyin 66ab309939 给全部源码补中文注释,并新增代码导览
- 67 个 .cs 文件加中文注释:每个文件顶部说明职责/调用方/线程与节拍/
  已知限制/「要改什么就改哪里」,字段与方法逐条一行说明,复杂逻辑内插关键步骤
- 纯注释改动:脚本校验所有新增行都是注释、无非注释改动(仅 2 个文件的 BOM
  随新头部注释下移,文件仍以 BOM 开头)
- 新增 docs/代码导览.md:模块地图、「我要改 X 看哪个文件」对照表、易踩的坑、
  悬浮条显示规则、测试与验收指引
- 编译通过,回归测试 23/23 通过

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-13 15:44:15 +08:00

89 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# tests —— 可运行的测试夹具
## 这些测试怎么跑、失败怎么办
本目录有两块东西,目的不同:
1. `uia-fixture/` —— 一个**独立进程**的真实 WinForms 窗口(`UiaFixture.exe`),用来让工具
跨进程做 UIA 读取/拾取/定位的人工验证。UIA 在**同一进程内**自读自身控件树会崩溃,所以必须
跨进程。构建并启动:`tests\run-fixture.cmd`(默认 Debug,可传 `Release`)。
2. `regression/RegressionTests.csproj` —— 自动化回归测试(net48 控制台程序),在纯内存快照或
本进程自建控件上跑断言,覆盖 XPath 定位、持久化/迁移、控件树增量刷新、悬浮条显示条件等。
它**不**用 UIA 读自身控件树(会崩溃)。
跑回归测试(不要在本目录直接 `dotnet build`,`src` 的 `bin\Debug` 可能被正在运行的工具进程锁定):
```bat
:: 用隔离的 OutputPath 构建,随后直接运行生成的 exe
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug ^
-p:OutputPath=%TEMP%\pacs-regression\ -v:minimal
%TEMP%\pacs-regression\RegressionTests.exe
```
- **退出码**:`0` = 全部用例通过;`1` = 存在失败(便于脚本/CI 判断)。
- **失败怎么办**:在输出里找 `FAIL <用例名>`,其下会打印异常的 message(含 expected/actual)。
按用例名到 `regression/*Tests.cs` 的 `Register(...)` 里定位对应方法。下拉/刷新类用例可设
环境变量 `PACS_REGRESSION_SCREENSHOTS=<目录>`,失败或关键步骤会自动把窗体截图写入该目录以便比对。
- **部分跳过是正常的**:个别断言依赖桌面上是否存在其他进程的窗口(如遮挡诊断的外部窗口用例),
缺失时会打印 `(... skipped)` 并跳过,不算失败。
真实 PACS/OCS 客户端要么不暴露 UIA(CEF 套壳),要么树太大没法人工核对。
这里放一个**普通 WinForms 窗口**,控件类型、名称、层级都是已知的,用来验证本工具的读取链路。
## 运行
```bat
tests\run-fixture.cmd :: Debug(默认)
tests\run-fixture.cmd Release :: Release
```
脚本会先用 `dotnet msbuild`(没有 dotnet 时用 `msbuild`)构建 `tests/uia-fixture`,
然后启动 `UiaFixture.exe`。也可以直接在 Rider / VS 里打开 `pacs_win_uia.sln` 单独运行这个项目。
## 窗口内容
| 窗口 | 内容 |
| --- | --- |
| `UIA 测试夹具` | 「控件」页:按钮、文本框、复选框、单选、下拉、两列 ListView、TreeView、状态标签;「表格」页:5 行 × 3 列 DataGridView;「嵌套」页:三层嵌套容器里的 ListBox |
| `UIA 测试夹具 - 第二个窗口` | 一个按钮(测试"选哪个窗口"、窗口列表分组与匹配) |
两个窗口的**标题与类名都固定**,所以保存的监控条目、悬浮条显示条件可以长期复用。
## 建议的验证清单
1. **控件树**:选中 `UIA 测试夹具` → 期望读到 Button/Edit/CheckBox/ComboBox/List/Tree 等节点,
「控件属性」里能看到控件Path、页面特征、焦点状态。
2. **拾取**:拾取「测试按钮」,期望拾取后控件树**以顶层窗口为根**展开并选中该按钮
(与窗口列表选中同一窗口得到的树一致),高亮框在拾取结束后消失。
2. **列表读取**:选中 DataGridView → 期望 5 行 × 3 列;ListView 走 MSAA/Win32 也应能读到行。
3. **path 往返**:在控件树里选中任意节点 → 复制「控件属性 → 控件Path」→ 杂项 →「按 path 定位…」→ 粘贴 → 定位,
期望命中同一个控件并在树上选中(这是"复制的 path 能不能用"的回归测试)。
4. **按 path 定位(故意写错)**:把路径中间一段改成不存在的名字,期望明确报出**第几段**没匹配,
而不是高亮到名字相同的另一个控件。
5. **监控列表**:添加一条指向「FixtureButton」的条目 → 点击该行立即出现红框、控件树展开到它;
点击标题、文本框、复选框那几行同样要有反应(点击任何位置都定位)。
6. **绘制所有控件框**:杂项 →「绘制所有控件框」,期望窗口里每个控件都套上一个细红框,
拖动/最小化目标窗口时框跟随/隐藏。
7. **命令与退出**:设置里加一条 `启动` 命令 `start "" notepad.exe`(测试用),退出工具后期望该进程被结束。
8. **拾取不触发目标**:拾取夹具窗口里的「测试按钮」时,期望按钮**不会被按下**(状态标签不变化,
见「控件」页右下角的状态文字),也不会抢走焦点。
> 注意:夹具只是测试目标,不要在里面放真实患者数据。
## 路径与持久化回归测试
`regression/RegressionTests.csproj` 是独立的 net48 console 测试工程。它引用主项目,在纯内存 `ControlTreeNode` 快照上覆盖 XPath、重复身份、转义、全节点 roundtrip、唯一性与不完整树;验证所有祖先 Name 改变后生成路径仍有效、稳定祖先锚定,以及 MSAA/Win32 来源不丢失。旧格式测试现在要求明确拒绝执行,旧文件仅保留用于人工编辑;保存前必须修正为 XPath。另验证动态字段不持久化、缺失刷新间隔默认300ms、悬浮条缺省启用值和显式停用值的区别,以及悬浮条窗口条件的严格匹配。测试不访问自身 UIA 或真实业务窗口。
新一轮界面验收:
- 静置控件树不应不断清空/重绘;更改目标控件文字只更新该节点;展开状态、选中和滚动保持。
- 双击监控 Path 打开多行编辑器;取消不改变配置,非法 XPath 不允许提交;编辑过程中不自动跳去定位。
- 悬浮条进程/类名/标题可以输入和下拉选择;导入 XPath 后使用“检测显示条件”核对不显示原因。
- Name 变化的定位方案见 `docs/XPath定位.md`。
在仓库根目录执行:
```bat
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug -v:minimal
tests\regression\bin\Debug\RegressionTests.exe
```