【测试实践】基于UnrealAutomator的UE4插件自动化测试实战指南-CSDN博客

1. 为什么你需要UnrealAutomator？从手动点点点到自动化测试的蜕变

如果你做过UE4项目的测试，尤其是手游或者UI比较复杂的项目，肯定经历过这样的场景：每次版本更新，都要手动把游戏里所有的按钮点一遍，检查背包、商城、任务列表有没有显示异常。功能一多，测试用例就爆炸，加班加点不说，还容易漏测。我之前带过一个项目，光是主界面就有几十个可交互控件，每次回归测试都要花上大半天，测试同学苦不堪言。

后来我们尝试了UE4自带的Automation测试框架，情况好了不少，至少一些核心逻辑能用C++写测试脚本自动跑了。但很快又遇到了新问题：怎么测试UI？怎么模拟玩家点击？怎么获取屏幕上某个按钮的坐标？这些UI层面的自动化，用原生的Automation框架写起来非常繁琐，甚至要直接操作Slate底层，门槛太高。

这时候，UnrealAutomator 这个插件就进入了我的视野。简单来说，它就是一个专门为UE4游戏测试打造的“瑞士军刀”。它基于UE4自带的HTTP Server，给你的游戏开了一个后门。通过这个后门，外部的测试脚本（比如用Python写的）可以发送指令给游戏，比如“点击屏幕(100,200)位置”、“获取当前所有UI控件树”、“执行某个GM命令”。这样一来，UI自动化、场景遍历、性能数据采集这些重复劳动，就都能用脚本搞定了。

我最初用它是为了做手游的兼容性测试。我们需要在几十台不同型号的真机上跑相同的测试用例，手动操作根本不可能。接入UnrealAutomator之后，我写了一个Python脚本，远程控制所有手机上的游戏客户端，自动执行登录、领奖、战斗等操作，并截图和收集日志。效率提升了不止一个量级。所以，无论你是QA工程师想提升测试效率，还是开发同学想给自己写的模块加一层自动化保障，UnrealAutomator都值得你花时间了解一下。它不是什么高深莫测的黑科技，而是一个能实实在在把你从重复劳动中解放出来的实用工具。

2. 手把手搭建环境：5分钟让UnrealAutomator跑起来

理论说再多，不如动手跑一遍。这里我以UE4.27版本为例，带你从头搭建一个可用的UnrealAutomator测试环境。放心，过程非常简单，我踩过的坑都会给你标出来。

第一步：获取插件。 UnrealAutomator是一个开源插件，代码在GitHub上。你不需要自己编译引擎，直接用现成的。打开它的GitHub仓库（utmhikari/UnrealAutomator），下载整个项目为ZIP，或者用Git克隆到本地。我建议直接下载ZIP包，解压起来最省事。

第二步：放入项目。 将解压后的 UnrealAutomator 文件夹（里面包含 Source、Resources 和 .uplugin 文件）整个复制到你UE4项目的 Plugins 目录下。如果你的项目没有 Plugins 文件夹，就在项目根目录（和 .uproject 文件同级）新建一个，然后再把插件放进去。这是UE4插件的标准存放位置。

第三步：启用插件。 打开你的UE4项目，在编辑器菜单栏找到 编辑（Edit） -> 插件（Plugins）。在弹出的插件浏览器窗口左侧，找到 测试（Testing） 分类。你应该能在列表里看到 UnrealAutomator。勾选它旁边的“已启用”复选框。这时候编辑器会提示你需要重启。点击“立即重启”，让插件生效。

第四步：验证与配置。 重启编辑器后，最关键的一步来了：启动插件的HTTP服务。UnrealAutomator默认会在游戏启动时，在本地某个端口（比如8080）启动一个HTTP服务器。为了验证它是否工作，我们最简单的方法是打包一个开发版（Development）的游戏。在编辑器里选择 播放（Play） 旁边的下拉箭头，选择 “独立进程游戏” 模式启动。游戏运行后，打开浏览器，输入地址 http://127.0.0.1:8080/。如果看到返回的JSON数据（可能是一些欢迎信息或API列表），恭喜你，服务启动成功了！