# 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 测试夹具` | 「控件」页:按钮、文本框、**富文本(FixtureRichText,内容只在 Value/Text 里,Name 是 "RichEdit Control")**、复选框、单选、下拉、两列 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 ```