Linux 上的基本工作流教程¶
本教程旨在说明 ecu.test Linux Runner 的工作方式。文中给出一个示例工作流,并引用用户手册中的相关章节。
步骤 1:准备工作区¶
ecu.test Linux Runner 不提供用于创建 Workspaces(工作区) 的 GUI。因此,必须先在 Windows 上使用 ecu.test 创建工作区,再将其传输到运行 ecu.test Linux Runner 的计算机;为此可以使用 git 等版本控制系统。或者,如果工作区已存在,也可以直接复制并迁移。
步骤 2:启动 ecu.test Linux Runner¶
本教程后续内容假定 Linux 用户为 tracetronic,且工作区位于以下路径:/home/tracetronic/workspace。
要启动 ecu.test Linux Runner,必须在控制台中执行命令“ecu.test”,并将工作区作为参数传入。
ecu.test --workspaceDir /home/tracetronic/workspace
当控制台输出中出现“REST API now available at 127.0.0.1:5050”消息时,表示 ecu.test Linux Runner 已成功启动。
步骤 3:通过 REST API 控制 ecu.test Linux Runner¶
必须使用 REST API 控制 ecu.test Linux Runner。更多 REST API 信息请参见 REST API Documentation(REST API 文档)。 在 ecu.test Linux Runner 运行期间,可在 http://127.0.0.1:5050/api/v2/ui 查看交互式文档。 下面给出一个在不使用 TBC 且不使用 TCF 的情况下运行 Package(测试包) simplepackage.pkg 的示例:
curl -X 'PUT' \
'http://localhost:5050/api/v2/execution' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"tbcPath": "",
"tcfPath": "",
"testCasePath": "simplepackage.pkg"
}'
如果需要让 ecu.test Linux Runner 支持远程访问 REST API,可以使用以下附加参数启动:
ecu.test --workspaceDir /home/tracetronic/workspace --restApiEnableRemoteAccess
端口可通过参数 –restApiPort PORT 设置(默认值:5050)。
步骤 4:结果评估¶
可以使用 REST API 的“execution”端点获取测试报告目录。
例如:
curl -X 'GET' \
'http://localhost:5050/api/v2/execution' \
-H 'accept: application/json'
响应:
{
"order": {
"executionId": "",
"tbcPath": "",
"tcfPath": "",
"testCasePath": "simplepackage.pkg"
},
"result": {
"reportDir": "/home/tracetronic/workspace/TestReports/simplepackage_2022-01-01_133700",
"result": "SUCCESS",
"subReportIds": [],
"testReportId": "1234567-aaa1-bbb2-ccc3-abcd1234a321"
},
"status": {
"key": "FINISHED",
"message": ""
}
}
传输报告目录后,即可使用 Report viewer(报告查看器) 对测试报告进行评估。ecu.test Linux Runner 会将所有输出保存到日志文件中。日志文件“ECU_TEST_OUT.log”和“ECU_TEST_ERR.log”位于以下目录:
/home/tracetronic/.cache/ecu.test 2026.3/