Pywinauto入门指南：Windows GUI自动化测试基础

Pywinauto入门指南：Windows GUI自动化测试基础

pywinauto pywinauto/pywinauto: 一个 Python 库，用于自动化 Windows 应用程序。特点是提供了丰富的函数和类库，可以用于控制鼠标、键盘和菜单等元素，实现自动化任务。 项目地址: https://gitcode.com/gh_mirrors/py/pywinauto

什么是Pywinauto

Pywinauto是一个强大的Python库，专门用于自动化Windows图形用户界面(GUI)应用程序的测试和操作。它允许开发者通过编程方式控制Windows应用程序，模拟用户交互行为，如点击按钮、输入文本、选择菜单等。

选择合适的后端技术

在开始使用Pywinauto之前，首先需要确定目标应用程序支持的Windows辅助技术(backend)：

1. Win32 API后端 (backend="win32")

   • 适用于传统的MFC、VB6、VCL应用程序
   • 支持简单的WinForms控件和大多数旧版应用程序

2. MS UI Automation后端 (backend="uia")

   • 适用于现代应用程序如WPF、WinForms、Qt5和浏览器
   • 支持Windows商店应用
   • 注意：Chrome需要添加--force-renderer-accessibility命令行参数才能支持

使用GUI对象检查工具

不确定该选择哪个后端？可以使用以下工具帮助判断：

1. Spy++ (Visual Studio自带)

   • 使用Win32 API
   • 如果Spy++能显示所有控件，则选择"win32"后端

2. Inspect.exe (Windows SDK自带)

   • 切换到UIA模式
   • 如果比Spy++显示更多控件细节，则选择"uia"后端

自动化入口点

Pywinauto提供了两种主要的自动化入口：

1. Application对象 - 用于控制单个应用程序实例

   from pywinauto.application import Application
   app = Application(backend="uia").start('notepad.exe')
   dlg = app.UntitledNotepad.wait('visible')
   

2. Desktop对象 - 用于跨进程边界操作

   from pywinauto import Desktop
   dlg = Desktop(backend="uia").Calculator
   dlg.wait('visible')
   

窗口规范(Window Specification)

窗口规范是Pywinauto的核心概念，允许你描述窗口或控件，即使它们尚未存在或已关闭：

# 创建窗口规范
dlg_spec = app.window(title='Untitled - Notepad')

# 获取实际窗口对象
real_window = dlg_spec.wrapper_object()

窗口规范支持多种匹配条件：

# 多级查找
app.window(title_re='.* - Notepad$').window(class_name='Edit')

# 组合条件
dlg.window(auto_id='num8Button', control_type='Button')

属性解析魔法

Pywinauto提供了便捷的属性解析方式：

app.UntitledNotepad  # 等同于 app.window(best_match='UntitledNotepad')
app['Untitled - Notepad']  # 支持特殊字符

如何识别控件名称

使用print_control_identifiers()方法可以查看控件的所有可用名称：

app.Properties.print_control_identifiers()

输出会显示每个控件的"best_match"名称列表，帮助你编写准确的定位代码。

禁用魔法属性查找

如果需要更严格的属性检查，可以禁用魔法查找：

app = Application(allow_magic_lookup=False)

实际应用示例

以下是控制记事本的基本示例：

from pywinauto.application import Application

# 启动记事本
app = Application(backend="win32").start('notepad.exe')

# 等待主窗口出现
dlg = app.UntitledNotepad.wait('visible')

# 绘制窗口轮廓（可视化）
dlg.draw_outline()

# 选择菜单
dlg.menu_select("编辑->替换")

# 打印替换对话框的控件标识
app.Replace.print_control_identifiers()

多语言支持注意事项

Pywinauto的示例通常是基于英文软件开发的。如果要自动化其他语言版本的应用程序，需要相应调整控件标题等属性。例如：

# 中文版记事本的菜单选择
dlg.menu_select("文件->另存为")

总结

Pywinauto为Windows GUI自动化测试提供了强大而灵活的工具集。通过选择合适的后端、理解窗口规范和属性解析机制，开发者可以高效地实现各种GUI自动化任务。建议从简单的应用程序如记事本开始练习，逐步掌握更复杂场景的自动化技巧。

pywinauto pywinauto/pywinauto: 一个 Python 库，用于自动化 Windows 应用程序。特点是提供了丰富的函数和类库，可以用于控制鼠标、键盘和菜单等元素，实现自动化任务。 项目地址: https://gitcode.com/gh_mirrors/py/pywinauto