Diff Viewer(差异查看器)

ecu.test 可用于便捷比较两个采用相同 ecu.test 专用文件格式的文件。因此,无需再基于 XML 格式的文本内容去还原变更。相反,可以在类似 ecu.test 主程序的友好界面中方便地分析差异。

支持以下文件格式:

  • Packages(.pkg)

  • Projects(.prj)

  • Testbench configurations(.tbc)

  • Test configurations(.tcf)

  • Mapping 文件(.xam)

  • 常量定义(.gcd)

  • 参数定义(.ppd)。

如果选中了两个相同文件格式的文件,上下文菜单中会出现 Compare elements 条目。选择后会打开一个新的 ecu.test Diff Viewer 窗口,其结构如下:

../_images/Diff.png

该用户界面由三部分组成:左侧有两列,分别显示两个文件中所包含的已选元素。右侧则以表格形式显示当前所选元素的属性。

两个文件中存在的元素变更会通过颜色表示。不同类型的变更使用以下配色进行可视化:

颜色

说明

浅蓝色

元素已移动

黄色

元素已更改

绿色

元素已添加

红色

元素已删除

紫色

元素已移动且已更改

浅黄色

元素的子元素中存在变更

黄色文字

该元素并非所有属性都受支持。元素可能已更改。

如果选中某个元素,另一个文件中对应的元素(如果存在)会被自动选中,并且两个元素周围会绘制黑色边框。元素的更改可以在右侧的表格中看到。在给出的示例中,选中的是变量 VALUE。在右侧的表格中,该元素所有已更改的属性都会标记为黄色。在本例中,初始值从 0 改为了 1。

设置与导航

图标

快捷键

操作

reload

F5

重新加载差异视图中的文件。

swap

Tab

交换左侧显示两个文件元素的两列。

expand

Ctrl +

展开左侧两列中的所有元素。

collapse

Ctrl -

折叠左侧两列中的所有元素。

spacer

当元素被删除、在另一文件中新增或已移动时,绘制灰色占位符。

spec

将 Package 视图缩减为 Spec-Package 的相关部分。

current

在使用“转到上一处/下一处差异”导航时,仅展开当前差异。

next

Ctrl + ↓

转到左侧列中的下一处差异。

prev

Ctrl + ↑

转到左侧列中的上一处差异。

text

Ctrl + T

在 TortoiseMerge 中打开文本 Diff。

限制

以下元素仅部分受支持,因此始终会显示为“已更改”:

  • Package - test case - 某些 test step:

    • AXS-Utilities

    • CANape-Script

    • Input dialog

    • HiL platform: RTT sequence administration

    • Inca HW access to units

    • User-Utilities

    • WinKFP flashing

    • Read reference

    • Write reference

  • Testconfiguration - Report

Info

当前比较文件时,仅支持 ecu.test 中当前选定的程序语言。例如,如果 ecu.test 中设置的语言为 English (U.S.),那么德语翻译中的变更将不会被识别为差异。

与 TortoiseGit 和 TortoiseSVN 集成

将 ecu.test Diff Viewer 集成到版本控制系统(TortoiseGit 或 TortoiseSVN)后,可以将某个文件与其上一版本,或者与本地修改前的版本进行比较。因此,需要在版本控制系统中将 ecu.test 定义为外部差异查看器。在 Version control system 的设置中,单击相应按钮即可为受支持的文件格式轻松完成此设置。如果希望对这些受支持的文件格式改用 TortoiseSVN 集成的文本比较工具进行比较,则需要单击 Text comparison 按钮以重置该设置。这样会删除之前创建的注册表项。

../_images/Diff-Versionskontrolle.png

Info

如果安装了新的 ecu.test 程序版本,则 TortoiseSVN 中的条目也必须更新为新的安装目录。可以先单击 Text comparison 按钮,再单击 ecu.test 按钮,即可轻松完成。此时,TortoiseSVN 中会重新创建包含当前程序路径的条目。

在 Windows 资源管理器中,或者在 ecu.test 的 package explorer 中,右键单击受版本控制的文件后,会看到上下文子菜单 TortoiseSVN、TortoiseGit 或 Versions control system。其中的 Diff with previous version 条目可将当前已保存的文件(右侧窗口,可能包含本地更改)与其上一修订版本(左侧窗口)进行比较。如果存在本地更改,上下文菜单中还会额外出现 Diff 条目,用于将本地文件修订版本(右侧窗口)与上次更新后的文件修订版本(左侧窗口)进行比较。

命令行接口

Package-Diff 的命令行接口如下:

ecu.test.exe --diff <FileOld> <FileNew>

参数

含义

<FileOld>

旧版本文件的路径

<FileNew>

新版本文件的路径