Library workspaces(库工作区)

使用库 Workspace 时,一个 Workspace 的 内容 可以在其他 Workspace 中复用。库中的更改会自动影响所有引用该库的 Workspace。库中的工件也会通过 EasyInsert 找到并直接插入。

要将这样的库集成到另一个工作区中,需要在 ecu.test 设置里指定其路径。

ecu.test 自带了一个示例工作区,作为 Tutorial library workspace(库工作区教程) 的组成部分,可用于逐步演练配置和使用库工作区所需的全部步骤。

Creation(创建)

要将某个工作区声明为库工作区,需要进行以下设置:

  1. 打开对话框 Options ‣ Settings ‣ Workspace-Settings。

  2. 配置 Title 和 Version。

  3. 启用复选框 Is a library

  4. 在 Namespace 字段中为该库输入一个唯一名称。

../_images/configureWorkspaceSettings.png

Warning

更改命名空间会导致引用失效。库工作区的命名空间必须唯一!这是为了避免同时使用多个库工作区时产生歧义。

Info

库工作区可以依赖其他库工作区。但这些传递依赖必须添加到主工作区的库列表中,否则由缺失依赖引起的错误要到测试运行时才会暴露。此外,顺序也很重要:传递依赖必须插入在其他依赖之前。

将工作区声明为库工作区后,ecu.test 中会发生一些变化。这些变化会在 Contents of library workspaces(库工作区的内容) 中进一步说明。

Usage(使用)

一个工作区可以引用任意数量的库工作区。集成方式是在 ecu.test 设置中指定相应库工作区的路径。

在 ecu.test 设置的 Libraries(库) 类别下,即 Workspace settings ‣ Libraries 中,可以管理这些库工作区。可使用 img_add、img_remove 和 img_edit 按钮添加、删除或编辑库工作区。

../_images/configureLibraries.png

Contents(内容)

以下元素可以外包到库中,以便集中维护和复用。其中还包括用于 Project、Package 和 Analysis Package 的 Templates。为了快速区分来自库的工件与来自主 Workspace 的工件,来自库的工件使用汽油蓝色图标。

Element(元素)

Standard icon(标准图标)

Library icon(库图标)

Package 和 Package template

package_icon

lib_package_icon

Analysis package 和 Analysis package template

analysis_package_icon

lib_analysis_package_icon

Project 和 Project template

project_icon

lib_project_icon

Test configurations

testConfiguration_icon

lib_testConfiguration_icon

Test bench configurations

testBenchConfiguration_icon

lib_testBenchConfiguration_icon

Project generator

prjgen_icon

lib_prjgen_icon

Package generator

pkggen_icon

lib_pkggen_icon

Parameter generator

pargen_icon

lib_pargen_icon

Global mapping

mappingfile_icon

lib_mappingfile_icon

Constants definition

globalconstantsfile_icon

lib_globalconstantsfile_icon

Trace step templates

no icon

no icon

User Python library

no icon

no icon

Report generator(报告生成器)

no icon

no icon

User-defined utility

no icon

no icon

User-defined Tools

no icon

no icon

如果通过工作区浏览器拖放或通过上下文菜单,将库工作区中的元素添加到主工作区中的 Package 或 Project,则始终会创建库引用。

Package(测试包)

来自库工作区的 Package 通过从工作区浏览器拖放的方式添加到 Package 中。这会创建一个库引用。有关不同 Package 引用类型的更多信息,请参见 Package references 章节。

../_images/libPackageCall.png

库工作区中的一个 Package 也可以调用同一库工作区中的另一个 Package。在这种情况下,该 Package 始终通过库引用集成。

Info

也可以将主 Workspace 中的 Package 集成到库 Package 中。与其他情况不同,此时始终生成绝对 Package 引用。由于是绝对路径引用,这种反向依赖会对库的可复用性产生负面影响!

Project(测试项目)

库工作区中的 Project 可以调用同一库工作区中的 Package 和 Project,也可以调用其他传递依赖库工作区中的内容。

Configurations(配置)

Test configurations (TCF) 和 Test bench configurations (TBC) 都可以迁移到库工作区中,以实现集中维护和复用。它们也可以分布在不同的库中进行管理。

Creation(创建)

配置既可以直接在相应库中创建和编辑,也可以在本地工作区中创建后保存到已引用的库中。

如果配置中包含对工件的引用,则适用以下限制:

  • 相对路径文件引用(例如总线数据库或 A2L/HEX 文件)始终相对于存储该配置的库工作区解析。因此,被相对引用的文件也必须存放在同一个库工作区中。

  • 或者,也始终可以指定绝对路径。

Important

TBC 中的基础路径 <workspace> 会将存储该 TBC 的库工作区用作基础路径。该基础路径用于某些工具的配置,并使得在工具配置中使用相对路径成为可能。

Usage(使用)

库中的配置可以像主 Workspace 中的配置一样,通过拖放放入配置区域或 Project 中。在后一种情况下,会向 Project 中插入一个 configuration change configChange_icon。只要 configuration change 中至少包含一个对库的引用,就会用蓝绿色图标 lib_configChange_icon 标记。

Migration assistance for moving to a library workspace(迁移到库工作区的辅助说明)

在某些情况下,将测试配置和测试台架配置从主工作区迁移到库工作区后,可能需要对其进行调整,以确保对常量定义文件、全局 Mapping 文件等工件的引用不会失效。

建议按以下步骤迁移配置:

  1. Move configurations(迁移配置)

    将配置文件(TCF + TBC)移动到库工作区。

  2. Migrate relatively referenced artifacts(迁移相对引用的工件)

    所有在已迁移配置中以相对路径指定的工件(例如模型文件、总线数据库、.a2l、.hex)也必须一并迁移到库工作区。如果文件夹结构未被完全保留,则必须调整配置中的相对路径。

  3. Check absolutely referenced artifacts(检查绝对引用的工件)

    绝对路径通常无需调整。但出于一致性考虑,建议检查这些工件是否也可以迁移到库工作区。

  4. Convert references to library references(将引用转换为库引用)

    • 在library workspace 中启动 ecu.test。

    • 删除测试配置 General 选项卡中全局 Mapping 文件(.xam)的条目,并重新选择已迁移到库工作区中的工件。

    • 删除测试配置 Global Constants 选项卡中常量定义文件(.gcd)和常量定义脚本(.py)的条目,并重新选择已迁移到库工作区中的工件。

    Info

    ecu.test 会自动创建如下形式的库引用:<libraries.libNamespace.parameters>\file。

  5. Verification in the library workspace(在库工作区中验证)

    选择并启动已迁移的配置。不应出现任何文件缺失消息,配置应能成功启动。

  6. Verification in the main workspace(在主工作区中验证)

    • 在主工作区中启动 ecu.test。

    • 从 library workspace 中选择并启动已迁移的配置。不应出现任何文件缺失消息,配置应能成功启动。

Trace step template(Trace 步骤模板)

来自库工作区的 Trace 步骤模板可通过 Trace step templates 标签页拖放到 Package 中。此时始终会创建库引用。

调用通过路径表达式定义。双击已添加的 Trace 步骤时可以看到该表达式的语法。它由以下元素组成:

libraries.<namespace of library>.traceStepTemplates + <relative trace step template path in the library workspace>

示例:libraries.exampleLibWorkspace.traceStepTemplate + 'MyLibTemplate.trcp'

../_images/libTraceStepTemplate.png

Generators(生成器)

库工作区中的 Project generators 也可以供主工作区中的 Project 使用。通过函数 prjgen_icon Project generator 的上下文菜单,可以创建并集成库工作区中的 Project 生成器到所选工作区 Project 中。每次对 Project 生成器的调用都会以唯一 ID 进行引用。

从库工作区调用 Project 生成器时,会在其名称前附加库工作区的命名空间,以便更好地区分。

示例:exampleLibWorkspace: CallOwnLibPackages

../_images/libProjektGenerator.png

与 Project 生成器类似,库工作区中的 package generators 和 parameter generators 也可以集成使用。

Templates

可以在 Library workspace(库工作区)中管理模板。这样在主 Workspace 中创建新对象时即可选择使用。

报告生成器

库工作区中的 Report generators(报告生成器)在 Test Configuration 的 Report 标签页中同样可用,并可在其中选择。 它们也会显示在 Report Viewer 中,并可用于生成报告。

有关可在自定义报告生成器中使用的命令概览,请参见 Report API。

Info

如果找到多个同名 Report generator,则适用以下优先级:

  1. Workspace

  2. 库工作区(库 的最后一项优先级最高)

  3. ecu.test 安装目录中的 Templates 目录

User Python library(User Python 库)

如果 User Python libraries 存储在库工作区中,也可以在主工作区的 Package 中调用。

要做到这一点,必须将 User Python 库函数的路径输入到 Calculation 测试步骤的 Expression 字段中。

Example: libraries.exampleLibWorkspace.user.return42Module.return42()

The module libraries.<NAMESPACE>.user must always be used as a prefix in the call.

../_images/libUserPyModule.png

Info

为避免命名冲突,user 模块在库工作区中不可用。

Important

因此,不应使用普通调用方式,

from user.MyModule import UserClass

而应使用如下调用方式:

from libraries.exampleLibWorkspace.user.MyModule import UserClass

其中 exampleLibWorkspace 是要从中导入的库工作区命名空间。

当然,也可以将现有的、存储在 user Python 库中的 ecu.test 用户自定义内容迁移到库中,例如 own package checks、customization of test management connection,以及 user defined image filters。