Choose your operating system:
Windows
macOS
Linux
FBX Test Builder是自动化系统的一部分,使用该插件可为各个FBX文件创建自己的测试。 FBX Test Builder为单个FBX文件创建测试计划(Test Plan)。使用该计划,可以执行导入或重新导入操作,并对照预期结果数组进行检查。创建的测试计划以JSON文件的形式存储, 文件名与所测试的FBX文件相同,但扩展名不同。
使用FBX Test Builder创建测试计划,可以对FBX文件执行选定的操作,然后对照预期结果数组检查, 以确定是否通过已完成的测试。
启用插件
在开始构建FBX自动化测试之前,需要先启用 FBXAutomationTestBuilder 插件。为此,请转至 编辑(Edit) > 插件(Plugins) > 测试(Testing)。
在启用插件后,需要重新启动虚幻引擎才能对其进行访问。
要访问FBX Test Builder,请从"文件"菜单中选择 窗口(Window) > 自动化工具(Automation Tools) > FBX Test Builder。
创建测试计划
使用FBX Test Builder时,它执行选定的 Action (或操作),并通过一系列 预期结果(Expected Results) 确定给定FBX文件是否通过测试。这组操作和结果称为 测试计划(Test Plan)。
操作
每个测试计划可以执行五个主要操作。每个操作都有其自己的条件,只有满足条件才能正确执行测试。 这些操作及其条件概述如下:
操作 |
步骤 |
---|---|
导入(Import) |
|
重新导入(Reimport) |
|
添加LOD(细节层级)(Add LOD (Level of Detail)) |
|
重新导入LOD(细节层级)(Reimport LOD (Level of Detail)) |
|
导入加载(Import Reload) |
|
预期结果
对于每个测试计划,评估 预期结果(Expected Results) 列表以确定是否通过测试。
设置 |
说明 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
预期预设类型(Expected Presets Type) |
应检查的预定义数据。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预期预设数据整型(Expected Presets Data Integer) |
输入应为指定的FBX文件检查的预期整型数值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预期预设数据浮点型(Expected Presets Data Float) |
输入应为指定的FBX文件检查的预期浮点型数值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预期预设数据双精度浮点型(Expected Presets Data Double) |
输入应为指定的FBX文件检查的预期双精度浮点型型数值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预期预设数据字符串型(Expected Presets Data String) |
输入应为指定的FBX文件检查的预期字符串型数值。 |
设置预期结果
为设置预期结果,我们使用包含6种不同材质和纹理的盒体网格体的FBX示例作为测试用例。
单击 添加(Add)(+)按钮添加"预期结果",然后选择要用于检查的 预期预设类型(Expected Preset Type)。
选择与要测试的"预期预设类型"对应的 预期预设数据(Expected Presets Data) 类型。在此示例中,选择 网格体材质数量(Mesh Materials Number) 类型, 以检查导入时FBX是否包含6种材质。
网格体材质数量(Mesh Materials Number) 预设类型只有一个整型数据(请使用预设工具提示或以上表格,参考所需的数据)来检查导入的材质数量。单击一下 预期预设数据整型(Expected Presets Data Integer), 将预期结果检查添加到数组中。
对于数组元素0,输入应使用FBX导入的材质数。此示例中预期的材质数量为6个。
确保设置必要的导入选项,以便正确导入所选"预期预设类型"要求的全部内容。例如,盒体FBX需要从 FBX导入材质和纹理,因此应启用 导入材质(Import Materials) 和 导入纹理(Import Textures) 选项。
单击 保存为JSON(Save JSON) 按钮,"测试计划"将添加到"会话前端自动化"(Session Frontend Automation)选项卡中。该文件可在 Engine/Import/FBX/[NameOfTheFBX] 中找到。
在运行测试后,操作系统会测试指定LOD(0)的 网格体材质数量(Mesh Materials Number)(6)是否与导入的资源数量相匹配。
如果测试失败,可以在"自动化"选项卡中选择该测试,然后在 自动化测试结果(Automation Test Results) 面板下查看失败的原因。
无论"会话前端"(Session Frontend)窗口是否打开,"消息日志"都会弹出,显示测试是成功还是失败,以及失败的原因。
导入选项
设置"预期结果测试计划"后,还必须确保将要测试的操作正确设置为导入/重新导入。 例如,如果要测试导入固定数量材质的FBX,请务必启用 导入材质(Import Materials)。这些选项与通过内容浏览器将资源导入编辑器时可用的选项相同。
有关更多信息,请参阅FBX导入选项页面。
创建测试计划的流程
请按照以下步骤为FBX测试创建测试计划:
将要测试的FBX复制到以下位置:
[UE4Root]/WorkingWithContent/Importing/FBXEditorAutomation
置于此文件夹中的任何FBX都将自动填充到 选择FBX文件(Select an FBX file) 下拉列表中。
使用 选择测试平面(Select a Test Plane) 下拉列表选择 创建新计划(Create new plan),或选择已存在的计划并进行编辑。
填写以下部分。
通用:(General:)
测试计划名称(Test Plan Name) - 为此测试计划命名,以便使用该名称从测试计划列表中进行选择。
操作(Action) - 选择要对FBX文件执行的操作类型。例如,导入、重新导入、添加LOD、重新导入LOD、重新导入加载等。
LOD索引(LOD Index) - 如果使用重新导入LOD,则输入要重新导入的LOD索引。
删除文件夹资源(Delete Folder Assets) - 是否在测试计划结束时删除导入的资源。
预期结果:(Expected Results:)
设置预期预设类型并填写完成测试所需的数据类型。
导入选项:(Import Options:)
设置成功导入此特定FBX以进行测试所需的导入选项。
单击 保存为JSON(Save JSON) 按钮保存测试计划,并将其添加为可在自动测试期间针对此FBX文件运行的测试。