Python-UIAutomation-for-Windows开发实践：从demo到实际项目的完整指南

Python-UIAutomation-for-Windows开发实践从demo到实际项目的完整指南【免费下载链接】Python-UIAutomation-for-Windows(Donot use 3.7.6,3.8.1):snake:Python 3 wrapper of Microsoft UIAutomation. Support UIAutomation for MFC, WindowsForm, WPF, Modern UI(Metro UI), Qt, IE, Firefox, Chrome ...项目地址: https://gitcode.com/gh_mirrors/py/Python-UIAutomation-for-WindowsPython-UIAutomation-for-Windows是一个强大的Windows UI自动化库它封装了Microsoft UIAutomation API支持MFC、Windows Form、WPF、Modern UI(Metro UI)、Qt、IE、Firefox、Chrome等多种应用程序的自动化控制。无论你是想自动化日常办公任务还是开发复杂的GUI测试脚本这个库都能为你提供强大的支持。 Python-UIAutomation-for-Windows入门指南安装与配置首先通过pip安装uiautomation库pip install uiautomation安装完成后系统会在Python脚本目录下生成一个automation.py脚本文件你可以使用它来遍历和查看UI控件。运行automation.py -h可以查看帮助信息快速开始从demo入手项目提供了丰富的demo示例位于demos/目录中。这些demo覆盖了从基础到高级的各种应用场景自动化记事本demos/automation_notepad.py - 演示如何控制Windows记事本自动化计算器demos/automation_calculator.py - 支持不同Windows版本的计算器自动化Wireshark自动化demos/automation_wireshark_qt5.py - Qt5应用程序的自动化示例GitHub Desktop控制demos/automation_devicemanager.py - 现代桌面应用的自动化 理解UI控件树结构Python-UIAutomation-for-Windows的核心概念是UI控件树。每个应用程序的界面都可以看作是一个树状结构从桌面根节点开始到顶层窗口再到具体的控件元素。使用automation.py工具可以查看当前系统的UI控件树# 查看当前活动窗口的控件 automation.py -t 0 -n # 查看桌面及其子窗口 automation.py -r -d 1 -t 0️ 控件模式与操作方法不同的UI控件支持不同的操作模式。Python-UIAutomation-for-Windows提供了完整的控件模式支持让你能够执行点击、输入、选择等各种操作。基本控件操作示例import uiautomation as auto # 查找记事本窗口 notepad_window auto.WindowControl(searchDepth1, ClassNameNotepad) # 查找编辑框并输入文本 edit_control notepad_window.EditControl() edit_control.Click() edit_control.SendKeys(Hello, Python-UIAutomation!) # 查找菜单项并点击 notepad_window.MenuItemControl(Name文件(F)).Click() notepad_window.MenuItemControl(Name保存(S)...).Click() 实际项目开发实践1. 自动化测试框架集成在实际项目中Python-UIAutomation-for-Windows可以作为自动化测试框架的核心组件。以下是一个测试框架的示例结构test_automation/ ├── __init__.py ├── base_page.py # 页面基类 ├── calculator_page.py # 计算器页面对象 ├── notepad_page.py # 记事本页面对象 ├── test_calculator.py # 计算器测试用例 ├── test_notepad.py # 记事本测试用例 └── conftest.py # 测试配置2. 页面对象模式实现使用页面对象模式可以提高代码的可维护性# base_page.py import uiautomation as auto class BasePage: def __init__(self, window_nameNone, class_nameNone): self.window auto.WindowControl( searchDepth1, Namewindow_name, ClassNameclass_name ) def wait_for_window(self, timeout10): return self.window.Exists(timeout, 0.5) def capture_screenshot(self, filename): self.window.CaptureToImage(filename) # calculator_page.py from base_page import BasePage class CalculatorPage(BasePage): def __init__(self): super().__init__(window_nameCalculator, class_nameApplicationFrameWindow) def click_number(self, number): button self.window.ButtonControl(AutomationIdfnum{number}Button) button.Click() def click_operator(self, operator): operator_map { : plusButton, -: minusButton, *: multiplyButton, /: divideButton, : equalButton } button self.window.ButtonControl(AutomationIdoperator_map[operator]) button.Click()3. 复杂应用程序自动化对于像Wireshark这样的复杂Qt应用程序Python-UIAutomation-for-Windows同样能够胜任# automation_wireshark_qt5.py 示例 import uiautomation as auto import subprocess class WiresharkAutomation: def __init__(self): self.wireshark_path C:\\Program Files\\Wireshark\\Wireshark.exe def start_capture(self, interfaceWi-Fi): # 启动Wireshark subprocess.Popen(self.wireshark_path) # 查找主窗口 main_window auto.WindowControl( searchDepth1, ClassNameQWidget, RegexNameWireshark.* ) # 选择网络接口 interface_combo main_window.ComboBoxControl(AutomationIdcaptureInterfaceComboBox) interface_combo.Select(interface) # 开始抓包 start_button main_window.ButtonControl(NameStart capturing packets) start_button.Click() return main_window4. 现代桌面应用自动化GitHub Desktop等现代桌面应用也能轻松自动化# github_desktop_automation.py import uiautomation as auto import time class GitHubDesktopAutomation: def __init__(self): self.app auto.WindowControl( searchDepth1, ClassNameChrome_WidgetWin_1, NameGitHub Desktop ) def clone_repository(self, repo_url, local_path): # 点击克隆按钮 clone_button self.app.ButtonControl(NameClone a repository) clone_button.Click() # 输入仓库URL url_input self.app.EditControl(AutomationIdrepositoryUrlTextBox) url_input.SendKeys(repo_url) # 选择本地路径 path_button self.app.ButtonControl(NameChoose...) path_button.Click() # ... 更多自动化步骤 性能优化技巧1. 精确搜索提高效率# 不推荐搜索深度过大性能差 edit uiautomation.EditControl(searchDepth10, Namemyedit) # 推荐分层搜索性能好 window uiautomation.WindowControl(searchDepth1, NameMyWindow) panel window.PaneControl(searchDepth1, NameContentPanel) edit panel.EditControl(searchDepth1, Namemyedit)2. 使用WalkControl批量处理# 遍历窗口中的所有按钮 buttons [] for control, depth in auto.WalkControl(window): if control.ControlType auto.ControlType.ButtonControl: buttons.append(control) # 批量操作 for button in buttons: if Save in button.Name: button.Click()3. 异步操作处理import threading import uiautomation as auto def async_automation_task(): # 在新的线程中执行自动化操作 window auto.WindowControl(searchDepth1, ClassNameNotepad) edit window.EditControl() edit.SendKeys(Async automation task) # 启动异步任务 thread threading.Thread(targetasync_automation_task) thread.start() 项目结构与最佳实践项目目录结构my_automation_project/ ├── config/ │ ├── __init__.py │ ├── settings.py # 配置文件 │ └── constants.py # 常量定义 ├── core/ │ ├── __init__.py │ ├── base_automation.py # 自动化基类 │ ├── element_locators.py # 元素定位器 │ └── wait_strategies.py # 等待策略 ├── pages/ │ ├── __init__.py │ ├── calculator_page.py │ ├── notepad_page.py │ └── wireshark_page.py ├── tests/ │ ├── __init__.py │ ├── test_smoke.py # 冒烟测试 │ ├── test_regression.py # 回归测试 │ └── conftest.py # pytest配置 ├── utils/ │ ├── __init__.py │ ├── logger.py # 日志工具 │ ├── screenshot.py # 截图工具 │ └── report_generator.py # 报告生成器 ├── requirements.txt ├── README.md └── main.py # 主程序入口配置管理最佳实践# config/settings.py import os from pathlib import Path class Settings: # 路径配置 BASE_DIR Path(__file__).parent.parent SCREENSHOT_DIR BASE_DIR / screenshots LOG_DIR BASE_DIR / logs # 自动化配置 SEARCH_TIMEOUT 10 SEARCH_INTERVAL 0.5 CLICK_WAIT_TIME 0.1 # 应用程序路径 NOTEPAD_PATH notepad.exe CALCULATOR_PATH calc.exe WIRESHARK_PATH C:\\Program Files\\Wireshark\\Wireshark.exe classmethod def setup_directories(cls): 创建必要的目录 cls.SCREENSHOT_DIR.mkdir(exist_okTrue) cls.LOG_DIR.mkdir(exist_okTrue) # 初始化目录 Settings.setup_directories() 调试与问题排查1. 使用自动化日志import uiautomation as auto # 启用调试模式 auto.uiautomation.DEBUG_SEARCH_TIME True auto.uiautomation.DEBUG_EXIST_DISAPPEAR True # 设置全局超时 auto.uiautomation.SetGlobalSearchTimeout(15) # 使用Logger记录操作 auto.Logger.WriteLine(开始自动化操作, auto.ConsoleColor.Green) auto.Logger.Write(查找窗口..., writeToFileTrue)2. 控件定位问题排查当控件无法找到时可以使用以下方法排查# 打印控件树结构 def print_control_tree(control, depth0): indent * depth print(f{indent}{control.ControlType} - {control.Name}) for child in control.GetChildren(): print_control_tree(child, depth 1) # 查找所有匹配的控件 all_buttons [] for ctrl, _ in auto.WalkControl(auto.GetRootControl()): if ctrl.ControlType auto.ControlType.ButtonControl: all_buttons.append(ctrl) print(f找到按钮: {ctrl.Name} - {ctrl.AutomationId})3. 截图辅助调试# 捕获整个窗口 window.CaptureToImage(debug_window.png) # 捕获特定控件 button.CaptureToImage(debug_button.png) # 捕获带光标的截图 window.CaptureToImage(debug_with_cursor.png, captureCursorTrue) 从Demo到生产环境阶段1学习与实验运行demos/目录中的所有示例修改示例代码理解每个参数的作用创建自己的简单自动化脚本阶段2项目化改造将脚本重构为模块化代码添加配置管理和错误处理实现日志记录和报告生成阶段3集成与部署将自动化脚本集成到CI/CD流程添加定时任务调度实现远程执行和监控 实际应用案例案例1批量文件处理自动化import uiautomation as auto import os from pathlib import Path class BatchFileProcessor: def __init__(self): self.notepad None def open_notepad(self): 打开记事本 import subprocess subprocess.Popen(notepad.exe) self.notepad auto.WindowControl( searchDepth1, ClassNameNotepad ) return self.notepad.Exists(5, 1) def process_files(self, directory_path): 批量处理目录中的文本文件 directory Path(directory_path) for file_path in directory.glob(*.txt): self.process_single_file(file_path) def process_single_file(self, file_path): 处理单个文件 # 打开文件 self.notepad.MenuItemControl(Name文件(F)).Click() self.notepad.MenuItemControl(Name打开(O)...).Click() # 文件对话框操作 file_dialog auto.WindowControl(Name打开) filename_edit file_dialog.EditControl(AutomationId1148) filename_edit.SendKeys(str(file_path)) open_button file_dialog.ButtonControl(Name打开(O)) open_button.Click() # 文件内容处理 edit self.notepad.EditControl() content edit.GetValuePattern().Value # 在这里添加你的处理逻辑 processed_content content.upper() # 示例转换为大写 # 保存处理后的文件 edit.GetValuePattern().SetValue(processed_content) self.notepad.MenuItemControl(Name文件(F)).Click() self.notepad.MenuItemControl(Name保存(S)).Click()案例2GUI应用程序测试自动化import pytest import uiautomation as auto from pages.calculator_page import CalculatorPage class TestCalculator: pytest.fixture(autouseTrue) def setup(self): self.calculator CalculatorPage() yield # 测试结束后关闭计算器 self.calculator.window.GetWindowPattern().Close() def test_addition(self): 测试加法功能 self.calculator.click_number(2) self.calculator.click_operator() self.calculator.click_number(3) self.calculator.click_operator() # 验证结果 result self.calculator.get_display_value() assert result 5, f预期结果为5实际得到{result} def test_multiplication(self): 测试乘法功能 self.calculator.click_number(4) self.calculator.click_operator(*) self.calculator.click_number(5) self.calculator.click_operator() # 验证结果 result self.calculator.get_display_value() assert result 20, f预期结果为20实际得到{result} 总结与展望Python-UIAutomation-for-Windows为Windows平台上的GUI自动化提供了强大而灵活的解决方案。通过本文的指南你已经了解了基础概念UI控件树、控件模式、搜索策略开发实践从demo学习到实际项目开发性能优化精确搜索、批量处理、异步操作项目结构模块化设计、配置管理、测试集成调试技巧日志记录、控件树查看、截图调试无论是简单的桌面应用自动化还是复杂的企业级测试框架Python-UIAutomation-for-Windows都能提供可靠的支持。现在就开始你的Windows自动化之旅吧记住良好的自动化脚本应该具备清晰的代码结构、完善的错误处理、详细的日志记录和可维护的测试用例。随着你对Python-UIAutomation-for-Windows的深入理解你将能够构建出更加健壮和高效的自动化解决方案。【免费下载链接】Python-UIAutomation-for-Windows(Donot use 3.7.6,3.8.1):snake:Python 3 wrapper of Microsoft UIAutomation. Support UIAutomation for MFC, WindowsForm, WPF, Modern UI(Metro UI), Qt, IE, Firefox, Chrome ...项目地址: https://gitcode.com/gh_mirrors/py/Python-UIAutomation-for-Windows创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考