兼容模式¶
兼容模式允许你在某个 ecu.test 版本中创建单个产物甚至整个 Workspace,同时保持它们与另一个 ecu.test 版本兼容。 例如,你可以使用最新版本的 ecu.test 创建一个 Package,同时确保它仍能用较早的 ecu.test 版本运行。这有助于使用不同 ecu.test 版本的团队之间协作。
Warning
即使在兼容模式下,也无法保证两个不同的 ecu.test 版本行为完全一致。API 的更改、工具行为的变化、新的 Python 版本等仍可能导致差异。
启用与配置¶
打开 ,选中 Enabled,可在 Workspace 设置 区域中完成。随后选择该 Workspace 应兼容的 ecu.test 版本。
该设置会影响新建或修改后的工件。现有工件不会自动更新。
如果为 Workspace 启用了兼容模式,则可在状态栏中看到这一点:“Compatibility mode”字样以及所选的兼容版本会显示在 Workspace 路径之后。
兼容模式也可以在 Library workspaces(库工作区) 中启用。 为此,必须打开库工作区本身 — 无法 从主工作区内配置此设置。
使构件兼容¶
并非所有功能或设置都能以兼容旧版本的方式保存。因此在保存时,ecu.test 会检查工件是否与所选的 ecu.test 版本兼容。如果存在无法转换为所选版本的元素,则会列出这些元素。如果可能,还会说明该元素不兼容的原因。同时,系统会自动确定能够以兼容方式保存该工件的最低 ecu.test 版本。随后用户可以选择:a) 改为按该版本保存工件,或 b) 取消保存操作。如果取消该流程,则可以手动检查并调整不兼容的元素。
尝试保存不兼容的工件时出现的对话框:在兼容模式中,目标版本设置为 2025.4,但某个 test step 要求至少为版本 2026.2。¶
在 Package 中,可以使用 检查 Package 提前识别不兼容的 test step。
一种特殊情况涉及来自集成 Library workspaces 的构件:首先需要注意的是,在库工作区中设置的 ecu.test 版本对检查具有决定作用,即使主工作区中设置了不同的 ecu.test 版本。如果要保存的构件不兼容,则无法保存。与主工作区的情况不同,此时不会建议最低兼容版本。要编辑这些构件,必须打开库工作区本身。
Info
在 workspace explorer 中,工件的兼容 ecu.test 版本会显示在 Compatibility 列中。右键单击列标题即可显示该列。
扩展过滤器可以使用 Compatibility 按保存的
ecu.test 版本进行过滤,例如 Compatibility < 2026.3。
迁移现有产物¶
要将现有工件改为配置的 ecu.test 版本,可以使用 Migrate workspace to compatibility version 迁移助手,通过 访问。只有在启用兼容模式时才能运行迁移。
该对话框会扫描 workspace,找出保存的 ecu.test 版本 与所选 ecu.test 版本不同的工件。兼容的工件会被自动保存。日志会列出 不兼容的工件和错误。
取消只会在当前正在处理的产物处理完成后停止迁移。
Object API¶
通过
Object API 保存时也会执行兼容性检查。
allowCompatibilityFallback 参数决定在无法按所选 ecu.test 版本保存时,是否允许回退到
支持的最低 ecu.test 版本。这与在 GUI 中保存时的行为类似。
Limitations¶
目前兼容模式不影响 Test bench configurations。 不过,如果希望 test bench configuration 保持兼容,更新时应 谨慎,因为可能会添加不兼容的属性。