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/