529f7910a1
问题:富文本(RichTextBox、Chromium/CEF、UWP 文本框)的 UIA Name 往往是通用标题 (实测夹具里是 "RichEdit Control"),真正的内容只在 ValuePattern/TextPattern 里; 而新增监控项时默认 ValueKey 是 Name,于是读回来的是标题而不是内容。 - ControlValueKeys 新增跨来源键「文本内容」:UIA 按 Value → Text → Name 顺序取, MSAA = accValue → accName,Win32 = 窗口标题;三种都取不到才报错并说明各自原因 - 新增/拾取控件时默认 ValueKey 改为「文本内容」(旧条目不受影响,仍按各自保存的键读) - 「文本内容」加进三个来源的可选键列表,监控列表下拉里能直接选 - 夹具新增多行富文本 FixtureRichText(内容只在 Value/Text 里) - 回归新增 ValueKeyTests(键表、Name 兜底、默认键),共 27/27 通过 实测(跨进程,目标为独立进程里的夹具窗口): - 文本框 文本内容="可编辑文本";富文本 文本内容="富文本第一行\r富文本第二行\r"; 按钮(无 Value/Text 模式)自动退回 Name="测试按钮" - 拾取点在两个控件上都精确命中 Edit / Document,且能在窗口树里找到同一节点 - 无界面读取端到端:2 条配置(//Document[...]、//Edit[...] + 文本内容)全部命中并取到值
216 lines
12 KiB
C#
216 lines
12 KiB
C#
// =====================================================================================
|
||
// pacs_win_uia 回归测试工程(net48 控制台程序,AssemblyName = RegressionTests)。
|
||
//
|
||
// 覆盖范围:
|
||
// - XPath 定位的解析 / 生成 / 转义 / 歧义与拒绝 ................ PathTests
|
||
// - 监控条目与设置的持久化、旧格式迁移、缺省值 ................ PersistenceTests
|
||
// - 控件树增量刷新时的节点身份保持 ............................ TreeRefreshTests
|
||
// - 悬浮条显示条件的窗口匹配与配置校验 ........................ FloatingConditionsTests
|
||
// - 悬浮条进程/类名/标题下拉的原生鼠标与键盘选择 .............. SettingsComboBoxTests
|
||
// - 遮挡诊断里“本工具自身窗口不算遮挡” ........................ WindowVisibilityTests
|
||
//
|
||
// 为什么这样测(重要):
|
||
// 用例都在**纯内存快照**(ControlTreeNode)或本进程自建的 WinForms 控件上运行,
|
||
// 绝不调用 UIA 去读本进程自己的控件树——UIA 自读会导致进程崩溃(见 MEMORY:
|
||
// in-process UIA self-reads segfault)。凡是必须走真实 UIA 的场景,请改用
|
||
// tests/uia-fixture 的独立进程做跨进程验证,不要在这里自读。
|
||
//
|
||
// 新增用例加在哪里:
|
||
// 按主题加到对应 *Tests.cs 的 Register(...) 列表里,并在该文件里实现一个
|
||
// private static void 方法;断言统一走 Check.*,不要自己 throw 或手写 Console 判断。
|
||
//
|
||
// Register 模式怎么用:
|
||
// 每个测试类提供 static Register(IList<KeyValuePair<string, Action>>),
|
||
// 把「用例名 → 委托」成对登记;Main 依次调用它们收集全部用例,再逐个执行并统计。
|
||
// =====================================================================================
|
||
using System;
|
||
using System.Collections.Generic;
|
||
using System.IO;
|
||
using System.Text;
|
||
using pacs_win_uia.Models;
|
||
using pacs_win_uia.Services;
|
||
|
||
namespace PacsWinUia.RegressionTests
|
||
{
|
||
internal static class Program
|
||
{
|
||
// 运行方式:不要在本目录直接 dotnet build(src 的 bin\Debug 可能被正在运行的工具进程锁定)。
|
||
// 用一个隔离的 OutputPath 构建,再直接运行生成的 exe:
|
||
// dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug
|
||
// -p:OutputPath=<隔离目录>\ -v:minimal
|
||
// <隔离目录>\RegressionTests.exe
|
||
// 退出码:0 = 全部用例通过;1 = 有任一用例失败(见 Main 末尾的 return)。
|
||
[STAThread]
|
||
private static int Main()
|
||
{
|
||
Console.OutputEncoding = new UTF8Encoding(false);
|
||
var tests = new List<KeyValuePair<string, Action>>();
|
||
// 各测试类把自己的用例登记进同一张表(顺序即执行顺序,彼此独立无共享状态)。
|
||
PathTests.Register(tests);
|
||
PersistenceTests.Register(tests);
|
||
TreeRefreshTests.Register(tests);
|
||
FloatingConditionsTests.Register(tests);
|
||
SettingsComboBoxTests.Register(tests);
|
||
WindowVisibilityTests.Register(tests);
|
||
ValueKeyTests.Register(tests);
|
||
int passed = 0;
|
||
// 逐个执行登记的用例:通过则 PASS 并累加,抛异常则 FAIL 并打印完整异常。
|
||
foreach (var test in tests)
|
||
{
|
||
try
|
||
{
|
||
test.Value();
|
||
passed++;
|
||
Console.WriteLine("PASS " + test.Key);
|
||
}
|
||
catch (Exception exception)
|
||
{
|
||
Console.WriteLine("FAIL " + test.Key);
|
||
Console.WriteLine(exception);
|
||
}
|
||
}
|
||
Console.WriteLine("RESULT total={0} passed={1} failed={2}", tests.Count, passed, tests.Count - passed);
|
||
// 退出码约定:0 = 全部通过,1 = 存在失败(供 CI / 脚本判断)。
|
||
return passed == tests.Count ? 0 : 1;
|
||
}
|
||
}
|
||
|
||
// Check —— 断言助手:所有用例统一用它抛 InvalidOperationException 表示失败,
|
||
// 失败信息里带上用例内传入的 message,便于定位。
|
||
internal static class Check
|
||
{
|
||
// 条件必须为真;否则以 message 抛异常。
|
||
public static void True(bool condition, string message)
|
||
{
|
||
if (!condition) throw new InvalidOperationException(message);
|
||
}
|
||
|
||
// 断言值相等(用默认相等比较器);失败时附带 expected/actual。
|
||
public static void Equal<T>(T expected, T actual, string message)
|
||
{
|
||
True(EqualityComparer<T>.Default.Equals(expected, actual),
|
||
message + "; expected=" + expected + "; actual=" + actual);
|
||
}
|
||
|
||
// 断言引用相同(节点必须还是原来那个对象,防止树刷新时被重建)。
|
||
public static void Same(object expected, object actual, string message)
|
||
{
|
||
True(ReferenceEquals(expected, actual), message + "; node reference mismatch");
|
||
}
|
||
|
||
// 断言 path 在 root 上按顺序解析到给定节点;唯一命中时额外校验 SelectUnique 也一致。
|
||
public static void Matches(ControlTreeNode root, string path, params ControlTreeNode[] expected)
|
||
{
|
||
string error;
|
||
IList<ControlTreeNode> actual = ControlPath.Select(root, path, out error);
|
||
Equal<string>(null, error, "Select error: " + path);
|
||
Equal(expected.Length, actual.Count, "Select count: " + path);
|
||
for (int i = 0; i < expected.Length; i++) Same(expected[i], actual[i], "Select order: " + path);
|
||
if (expected.Length == 1)
|
||
{
|
||
Same(expected[0], ControlPath.SelectUnique(root, path, out error), "SelectUnique: " + path);
|
||
Equal<string>(null, error, "SelectUnique error: " + path);
|
||
}
|
||
}
|
||
|
||
// 断言 path 被拒绝:Select 返回空、SelectUnique 返回 null,且都带非空错误信息。
|
||
public static void Rejected(ControlTreeNode root, string path)
|
||
{
|
||
string error;
|
||
Equal(0, ControlPath.Select(root, path, out error).Count, "Rejected path returned nodes: " + path);
|
||
True(!string.IsNullOrWhiteSpace(error), "Rejected path lacks error: " + path);
|
||
Equal<ControlTreeNode>(null, ControlPath.SelectUnique(root, path, out error), "Rejected path uniquely resolved: " + path);
|
||
True(!string.IsNullOrWhiteSpace(error), "Rejected unique path lacks error: " + path);
|
||
}
|
||
}
|
||
|
||
// 每个持久化用例独占一个临时目录,Dispose 时递归删除;不碰真实用户配置目录。
|
||
internal sealed class TemporaryDirectory : IDisposable
|
||
{
|
||
public TemporaryDirectory()
|
||
{
|
||
DirectoryPath = Path.Combine(Path.GetTempPath(), "pacs-win-uia-regression-" + Guid.NewGuid().ToString("N"));
|
||
Directory.CreateDirectory(DirectoryPath);
|
||
}
|
||
|
||
public string DirectoryPath { get; private set; }
|
||
public string File(string name) { return Path.Combine(DirectoryPath, name); }
|
||
public void Dispose() { Directory.Delete(DirectoryPath, true); }
|
||
}
|
||
|
||
// Every node is an in-memory snapshot: no AutomationElement, HWND lookup, GUI or provider calls.
|
||
//
|
||
// TreeFixture —— 供 XPath 用例复用的纯内存控件树夹具,结构:
|
||
// Window(设置, RootClass)
|
||
// ├─ Custom(PermanentNavigationView)
|
||
// │ ├─ Group(...BreadcrumbBar) > Button(个性化) > Text(个性化) → BreadcrumbText
|
||
// │ └─ Window(PaneRoot) > Pane(MenuItemsScrollViewer) > Group(MenuItemsHost)
|
||
// │ └─ ListItem(个性化) → MenuItem
|
||
// ├─ Group(Duplicates):重复 AutomationId、同名异类型、有无 Id、无名字等边界节点
|
||
// └─ Text/Edit:中文、单双引号、斜杠、> < & [ ] 等转义样本
|
||
// Node(...) 造节点、Add(...) 挂子节点、All(...) 深度优先枚举,供 roundtrip/改名校验遍历全树。
|
||
internal sealed class TreeFixture
|
||
{
|
||
public const string BreadcrumbLegacy = "[Uia] Custom[PermanentNavigationView] > Group[PermanentNavigationViewBreadcrumbBar] > Button:个性化 > Text:个性化";
|
||
public const string MenuLegacy = "[Uia] Window:设置 > Custom[PermanentNavigationView] > Window[PaneRoot] > Pane[MenuItemsScrollViewer] > Group[MenuItemsHost] > ListItem:个性化";
|
||
public readonly ControlTreeNode Root;
|
||
public readonly ControlTreeNode Navigation;
|
||
public readonly ControlTreeNode BreadcrumbText;
|
||
public readonly ControlTreeNode MenuItem;
|
||
public readonly ControlTreeNode Duplicates;
|
||
public readonly ControlTreeNode FirstDuplicate;
|
||
public readonly ControlTreeNode SecondDuplicate;
|
||
public readonly ControlTreeNode NameWithId;
|
||
public readonly ControlTreeNode NameWithoutId;
|
||
public readonly ControlTreeNode Nameless;
|
||
public readonly ControlTreeNode EscapedName;
|
||
public readonly ControlTreeNode EscapedId;
|
||
|
||
public TreeFixture()
|
||
{
|
||
Root = Node("Window", "设置", null, "RootClass");
|
||
Navigation = Add(Root, Node("Custom", null, "PermanentNavigationView"));
|
||
var breadcrumb = Add(Navigation, Node("Group", null, "PermanentNavigationViewBreadcrumbBar"));
|
||
BreadcrumbText = Add(Add(breadcrumb, Node("Button", "个性化")), Node("Text", "个性化"));
|
||
var paneRoot = Add(Navigation, Node("Window", null, "PaneRoot"));
|
||
var scroll = Add(paneRoot, Node("Pane", null, "MenuItemsScrollViewer"));
|
||
var host = Add(scroll, Node("Group", null, "MenuItemsHost"));
|
||
MenuItem = Add(host, Node("ListItem", "个性化"));
|
||
Add(host, Node("ListItem", "系统"));
|
||
Duplicates = Add(Root, Node("Group", null, "Duplicates"));
|
||
FirstDuplicate = Add(Duplicates, Node("Button", "重复", "same-id", "PrimaryButton"));
|
||
Add(Duplicates, Node("Text", "同级异类型"));
|
||
Add(Duplicates, Node("Button", "其他", "other-id", "OtherButton"));
|
||
SecondDuplicate = Add(Duplicates, Node("Button", "重复", "same-id", "SecondaryButton"));
|
||
NameWithId = Add(Duplicates, Node("Button", "混合名称", "has-id"));
|
||
NameWithoutId = Add(Duplicates, Node("Button", "混合名称"));
|
||
Nameless = Add(Duplicates, Node("Button"));
|
||
Add(Duplicates, Node("Button"));
|
||
EscapedName = Add(Root, Node("Text", "中文 '单引号' \"双引号\" /斜杠 > 大于 & < [括号]"));
|
||
EscapedId = Add(Root, Node("Edit", "输入", "id'\"/ > 中文 & <", "class'\"/ > 中文 & <"));
|
||
}
|
||
|
||
public static ControlTreeNode Node(string type, string name = null, string id = null, string className = null)
|
||
{
|
||
return new ControlTreeNode
|
||
{
|
||
Source = ControlTreeSource.Uia,
|
||
Uia = new UiaElementInfo { ControlType = "ControlType." + type, Name = name, AutomationId = id, ClassName = className }
|
||
};
|
||
}
|
||
|
||
public static ControlTreeNode Add(ControlTreeNode parent, ControlTreeNode child)
|
||
{
|
||
parent.Children.Add(child);
|
||
return child;
|
||
}
|
||
|
||
public static IEnumerable<ControlTreeNode> All(ControlTreeNode root)
|
||
{
|
||
yield return root;
|
||
foreach (ControlTreeNode child in root.Children)
|
||
foreach (ControlTreeNode descendant in All(child)) yield return descendant;
|
||
}
|
||
}
|
||
}
|