WinAppDriver 环境配置实操指南：5 个步骤跑通第一个自动化用例

WinAppDriver 环境配置实操指南5 个步骤跑通第一个自动化用例【免费下载链接】WinAppDriverWindows Application Driver项目地址: https://gitcode.com/gh_mirrors/wi/WinAppDriver你手里有一个 Win32 老应用想回归验证它的按钮点击逻辑但项目里没有任何现成的 UI 自动化手段手动点测既慢又不可靠。WinAppDriver 就是为这个场景存在的它是微软官方的 Windows UI 自动化驱动服务以类 Selenium 的方式把 UWP、WPF、WinForms、Win32 应用的 UI 暴露给测试脚本。这篇文章按自检 → 安装 → 验证 → 排障的顺序带你把 WinAppDriver 环境配置一次做对。环境自检装之前先确认这 4 件事WinAppDriver 对运行环境有硬性要求缺任何一项都会在后面某个环节卡住你。装之前花两分钟确认一遍前置条件确认方法Windows 10家庭版/专业版或 Windows Server 2016按 WinR 输入 winver查看版本信息开发人员模式已开启设置 → 隐私和安全性 → 开发者选项确认开关处于打开状态管理员权限可用能打开以管理员身份运行的命令行即可脚本运行环境满足依赖C# 示例工程需要 .NET Framework 4.6.1 及以上其中开发人员模式最容易被忽略它是 WinAppDriver 识别和启动 UWP 应用的底层依赖没开的话服务能起来但创建会话会失败。安装 WinAppDriver 与启动服务安装和启动合并成三个节点每个节点都告诉你做对了长什么样。节点一获取安装程序从 WinAppDriver 官方 Releases 页面下载最新版本的安装程序如果你还需要示例工程和工具源码可以克隆仓库git clone https://gitcode.com/gh_mirrors/wi/WinAppDriver做对了长什么样你手上有一个 WinAppDriver 安装包以及一个包含 Samples、Tests、Tools 的源码目录。节点二运行安装程序双击安装程序按向导完成安装。默认路径是C:\Program Files (x86)\Windows Application Driver\记住这个位置启动服务要用。做对了长什么样安装目录里能看到WinAppDriver.exe。节点三以管理员身份启动服务右键以管理员身份打开命令提示符进入安装目录并运行WinAppDriver.exe做对了长什么样命令行停留并输出服务启动信息此时服务监听127.0.0.1:4723。做错了会怎样非管理员启动会直接拒绝运行端口被占用则提示端口冲突换端口重启即可。默认只监听本机地址。如果你要把脚本跑在另一台机器上给 exe 传两个参数就行第一个是监听 IP第二个是端口WinAppDriver.exe 10.0.0.10 4725注意只要不是默认的本机 4723就必须以管理员身份运行这是硬性规则。跑通第一个用例用计算器验证环境环境装好了但装好不能只靠服务窗口没报错来判断要跑一个真实用例。最省事的验证路径是仓库自带的计算器示例工程Samples/C#/CalculatorTest用 Visual Studio 打开 CalculatorTest.sln确认CalculatorSession.cs里的服务地址是http://127.0.0.1:4723测试工具窗口里选择ScenarioStandard右键执行。预期结果测试控制台启动一个计算器实例脚本依次点击 1、、7、然后读取结果显示区断言等于 8。全部用例绿色通过、测试会话最后被正常关闭说明服务监听正常、客户端连接成功、UI 操作链路完整——这就是到底能不能跑最直观的答案。高频卡点排查权限、端口、开发人员模式现象启动命令一闪而过或提示Access Denied。原因没用管理员权限运行WinAppDriver.exe。解法右键命令提示符选择以管理员身份运行再进安装目录启动。现象启动即报端口已被占用服务起不来。原因上一个 WinAppDriver 进程没退干净或其他程序占了 4723。解法先定位占用进程netstat -ano | findstr 4723用任务管理器按 PID 结束旧进程后重启或者临时换个端口例如WinAppDriver.exe 4727——同时记得把测试脚本里的服务地址改成http://127.0.0.1:4727两边一致才能连上。现象服务正常监听但创建计算器会话时报错、应用窗口起不来。原因开发人员模式没开UWP 应用无法被识别和拉起。解法到 设置 → 隐私和安全性 → 开发者选项 打开开关重启服务再试。进阶方向录 UI、写脚本、上远程环境跑通之后有三个方向可以继续挖UI 录制器Tools/UIRecorder/下的独立工具录制你的 UI 操作并自动生成 XPath 和 C# 代码写脚本的起步成本很低元素定位策略计算器示例同时演示了按 Name、AccessibilityId、XPath 三种方式定位配合 Inspect 工具查看元素属性能覆盖绝大多数场景远程机器运行CI 或跨机执行场景下给服务传入非本机 IP 并配置防火墙放行即可。仓库的 Docs 目录里有 API 支持列表、测试脚本编写指南和远程运行说明细节都能查到。下一步很明确打开 CalculatorTest把Addition里的 17 改成你想测的操作开始写你的第一条自动化脚本。【免费下载链接】WinAppDriverWindows Application Driver项目地址: https://gitcode.com/gh_mirrors/wi/WinAppDriver创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考