Files
Mitchell Wilson 0b47855b71 Copying //UE4/Dev-Documentation to Samples-Main (//UE4/Samples-Main) CL - 4860397
#rb none

[CL 4860421 by Mitchell Wilson in Main branch]
2019-01-31 15:30:04 -05:00

175 lines
7.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
INTSourceChangelist:3801260
Availability: Public
Crumbs: %ROOT%
Title:自动化系统用户指南
Description:使用自动化系统运行测试的指南。
Type: Overview
SkillLevel:Intermediate
Version:4.17
Parent:Programming/Automation
Order:1
Tags:Programming
Topic-image:SessionFrontend_Topic.png
Social-image:SessionFrontend.png
[TOC(start:2 end:3)]
[REGION:fullwidth]
![](SessionFrontend.png)
[/REGION]
[REGION:caption]
聚焦于“自动化Automation”选项卡的“会话前端Session Frontend”屏幕截图。
[/REGION]
**自动化Automation** 选项卡是 **会话虚幻前端Session (Unreal) Frontend** 的其中一部分。它位于此处的原因是便于你在连接到计算机或位于本地网络上的任何其他设备上运行自动化测试。
你可通过两种方式访问前端套件:
* **会话前端Session Frontend** - 将本地编辑器作为自动化工作线程打开,以在外部设备上运行自动化。
* 导航至 **窗口Window** > **开发者工具Developer Tools** > **会话前端Session Frontend**
* **虚幻前端Unreal Frontend** - 打开包含“会话前端Session Frontend”、“设备管理器Device Manager”和“项目启动程序Project Launcher”的独立版“前端Frontend”。
* 导航至 **[UE4根目录]** > **Engine** > **Binaries** > **Win64** > **UnrealFrontend.exe**
(#enablingplugins)
## 启动插件
在最新版本的虚幻引擎4中所有的自动化测试都从“Engine Content”文件夹中移到了它们的插件中必须先启用插件
然后才能在“自动化Automation”选项卡中看到它们。
[REGION:imagetable]
| [REGION:lightbox]![](OpenPluginBrowser.png)(h:412)[/REGION] | [REGION:lightbox] [![](PluginsBrowserTesting.png)(w:500)](OpenPluginBrowser.png) [/REGION] |
| --- | --- |
| 要启用插件,选择 **编辑Edit** > **插件Plugins** > **测试Testing**。| 包含自动化测试的“插件Plugins”浏览器 |
[/REGION]
[REGION:note]
如果使用独立版“虚幻前端Unreal Frontend无需任何额外的启用步骤就可访问所有自动化测试。
[/REGION]
(#userinterface)
## 用户界面
打开“会话前端Session Frontend”后你可以访问“控制台Console”、“自动化Automation”、“屏幕截图比较Screenshot Comparison”和“分析器Profiler”等选项卡。对于你的自动化测试需求
**自动化Automation** 选项卡中将包含你所需的所有功能,而一些额外功能位于 [屏幕截图比较Screenshot Comparison](Programming/Automation/ScreenShotComparison) 选项卡下,
它适用于渲染功能比较。
[REGION:lightbox]
[![](AutomationTab.png)(w:850)](AutomationTab.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
[REGION:note]
如果未在“自动化Automation”选项卡窗口中看到任何显示内容请从左侧的会话浏览器中选择一个活动会话。例如在 **此应用程序This Application** 下面,名称为 **RDU-WD** 的机器处于选中状态。
[/REGION]
(#sessionbrowser)
### 会话浏览器
借助 **会话浏览器**你可以连接到编辑器的特定实例。选择会话之后你才会在“自动化Automation”窗口中看到填充的可用自动化测试。
![](SessionBrowser.png)
(#toolbar)
### 工具栏
借助“自动化Automation”选项卡中的工具栏你可以控制启动自动化测试、刷新自动化测试以及过滤自动化测试错误和警告的方式。
[REGION:lightbox]
[![](AutomationToolbar.png)(w:850)](AutomationToolbar.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
[REGION:simpletable]
| 图标 | 名称 | 说明 |
| --- | --- | --- |
| ![](StartTests.png) | **启动测试Start Tests** | 启动和停止已启用且当前已选择的自动化测试。在此按钮下,还会显示即将运行的测试的数量,以供你参考。|
| ![](RunLevelTests.png) | **运行关卡测试Run Level Test** | 如果当前加载的关卡是测试地图,你可以单击此按钮选择测试并立即运行它。|
| ![](RefreshTests.png) | **刷新测试Refresh Tests** | 单击此按钮可刷新添加到项目中的所有测试的测试名称列表。|
| ![](FindWorkers.png) | **查找工作线程Find Workers** | 单击此按钮可查找可用于执行测试的本地工作线程。|
| ![](Errors.png) | **错误Errors** | 单击此按钮可为“测试Test”窗口切换过滤器该过滤器显示尝试完成的过程中发生错误的所有测试。|
| ![](Warnings.png) | **警告Warnings** | 单击此按钮可为“测试Test”窗口切换过滤器该过滤器显示尝试完成的过程中出现警告的所有测试。|
| ![](DevContent.png) | **开发者内容Dev Content** | 启用时,将在自动化测试中包含开发者目录。|
| ![](DeviceGroups.png) | **设备组Device Groups** | 借助它,你可以基于机器名、平台、操作系统版本等一系列选项对测试进行分组。|
| ![](Presets.png) | **预设值Preset** | 借助它,你可以使用已选择的测试和设置添加你自己的自动化测试预设值,以便在以后重复使用它们。|
[/REGION]
(#testswindowandresults)
### 测试窗口和结果
在自动化测试窗口和“自动化测试结果Automation Test Results”面板中你可以看到与已经运行的测试相关的信息例如完成测试的机器、已运行测试
的数量、失败的测试的数量等。
[REGION:lightbox]
[![](TestsAndResultsPanels.png)(w:850)](TestsAndResultsPanels.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
[REGION:tip]
你可以使用 **设备组Device Groups** 按钮来确定开始运行新的自动化测试时,信息在结果面板中的分组方式。
![](DeviceGroupsDropdown.png)
[/REGION]
查看结果时,可使用 **显示Display** 选项显示测试的 **名称Name** 和完成测试花费的 **时间Time**。
[REGION:lightbox]
[![](Display.png)(w:850)](Display.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
当收到错误或警告时,你可以在主测试窗口中单击测试,以便让具体的错误/警告在结果面板中显示。
[REGION:lightbox]
[![](FailureMessage.png)(w:850)](FailureMessage.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
(#export)
### 导出
测试完成后,可通过 **导出Export** 下拉菜单将结果导出到CSV文件中。
[REGION:lightbox]
[![](ExportTests.png)(w:850)](ExportTests.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]
从可用过滤器中选择要导出的过滤器,然后选择 **导出数据Export Data** 按钮。
![](ExportData.png)
导出数据后会显示弹出消息指示导出是否成功以及CSV文件保存位置。
![](ExportDataSuccessful.png)
[REGION:note]
**导出Export** 下拉菜单仅在报告生成后才会处于活动状态,**导出数据Export Data** 按钮仅在有报告满足过滤条件时处于活动状态。
[/REGION]
(#copy)
### 复制
测试完成后,你可以选择 **自动化测试结果Automation Test Results** 面板中显示的任意多行并单击 **复制Copy** 按钮来将这些行复制到剪贴板,然后粘贴到任意位置。
[REGION:lightbox]
[![](Copy.png)(w:850)](Copy.png)
[/REGION]
[REGION:caption] 单击查看大图。[/REGION]