第3章 AutomationDesk基础

第3章：AutomationDesk基础——界面布局、项目结构、工作区与库管理

好，咱们开始聊AutomationDesk。说实话，我第一次打开这个工具的时候，第一反应是——嗯，界面挺清爽的。但紧接着就有点懵：这么多窗口，到底哪个是干嘛的？

别急，我带你捋一遍。搞清楚了界面布局和项目结构，后面写测试序列才会顺手。

3.1 界面布局：别被窗口吓到

AutomationDesk的界面，说白了就是典型的IDE风格。你用过VS Code或者Eclipse的话，上手会很快。

默认布局分这么几块：

菜单栏和工具栏：在最上面。新建、保存、运行、调试，都在这里。我个人习惯把常用的几个按钮拖到快捷工具栏，省得每次去菜单里翻。
项目浏览器（Project Explorer）：左侧。这是你的项目文件树，所有测试用例、库、配置文件都在这。
工作区（Work Area）：中间最大那块。你写测试序列、画流程图、编辑参数，全在这。
输出窗口（Output）：底部。编译信息、运行日志、错误提示，都往这吐。
属性窗口（Properties）：右侧或底部。选中某个元素，它的参数就在这里显示和修改。

小技巧：如果你不小心把某个窗口关掉了，别慌。在菜单栏找到「Window」→「Show View」，就能重新打开。我刚开始用的时候，经常把输出窗口弄丢，后来干脆把它固定在了底部。

3.2 项目结构：一个项目到底装了什么？

你新建一个AutomationDesk项目，会看到一堆文件夹。别觉得乱，其实结构很清晰。

典型的项目结构长这样：

MyHILProject/
├── TestCases/          # 测试用例文件夹
│   ├── TestCase1.pkg   # 单个测试用例
│   └── TestCase2.pkg
├── Libraries/          # 库文件夹
│   ├── CommonLib.pkg   # 公共库
│   └── VehicleModel.pkg
├── Config/             # 配置文件
│   ├── PlatformConfig.xml
│   └── MappingConfig.xml
├── Results/            # 测试结果
│   └── 2025-01-15_TestReport.html
└── Project.paj         # 项目文件（双击打开项目）

我来解释一下每个部分：

TestCases：你的测试用例都放这里。每个.pkg文件就是一个测试包，里面可以包含多个测试序列。
Libraries：公共库。比如你写了一个「发动机转速计算」的函数，放在库里，所有测试用例都能调用。避免重复造轮子。
Config：平台配置和信号映射。说白了，就是告诉AutomationDesk：你的HIL台架是什么型号，信号怎么连。
Results：跑完测试自动生成的报告。HTML格式，可以直接用浏览器打开看。

重点：.paj文件是项目的入口。你发给同事项目时，记得把这个文件一起发。我遇到过有人只发了.pkg文件，结果对方打不开，因为缺少项目配置。

3.3 工作区：你写代码的地方

工作区就是中间那块画布。你在这里拖拖拽拽，就能搭出一个测试序列。

AutomationDesk支持两种编辑模式：

流程图模式（Flow Chart）：图形化编程。用方块和箭头表示逻辑。适合直观展示测试流程，也适合给非开发人员看。
脚本模式（Script）：直接写Python代码。灵活，但需要你会写脚本。

我个人习惯是：复杂逻辑用脚本，简单流程用流程图。举个例子，一个「上电-等待-检测电压」的测试，流程图一目了然。但如果你要做复杂的数学运算或者循环嵌套，还是写脚本更高效。

注意：流程图和脚本可以混用。你可以在一个测试序列里，某些步骤用流程图，某些步骤用脚本。但别混得太乱，否则后面维护起来想哭。我曾经接手过一个项目，一个测试序列里流程图和脚本来回切换了七八次，调试的时候差点崩溃。

3.4 库管理：别重复造轮子

库管理是AutomationDesk里非常实用的功能。说白了，就是把常用的函数、测试步骤、参数封装起来，供多个测试用例调用。

库的类型主要有：

库类型	说明	使用场景
函数库	封装可复用的函数	比如信号读取、数据转换、延时等待
测试步骤库	封装完整的测试步骤	比如「上电流程」、「CAN报文发送」
参数库	存放全局参数	比如电压阈值、时间常量、信号ID

怎么用？很简单：

在项目浏览器里右键「Libraries」文件夹，选择「New Library」。
给库起个名字，比如「CommonFunctions」。
在库里创建函数或步骤，写好逻辑。
在测试用例里，直接拖拽库里的函数到工作区，就能用了。

避坑指南：我曾经犯过一个错——把库文件放在项目外部。结果项目拷贝到别的电脑上，库路径变了，所有测试用例都报错。后来我学乖了，库文件一律放在项目内部的Libraries文件夹里，用相对路径引用。

3.5 实战建议：从零搭一个项目

说了这么多，不如动手试试。我建议你按这个步骤来：

新建一个AutomationDesk项目，保存到本地。
在TestCases文件夹下，新建一个测试包，随便写一个简单的测试序列（比如读取一个信号值）。
在Libraries文件夹下，新建一个函数库，写一个「延时等待」的函数。
在测试序列里调用这个库函数，跑一下看看效果。
跑完后，去Results文件夹里打开测试报告，看看结果。

做完这一步，你对AutomationDesk的基本操作就有感觉了。后面我们再深入聊测试序列的具体写法。

嗯，这一章就到这里。记住：界面布局是骨架，项目结构是血肉，库管理是工具。三样都搞明白了，你才算真正入了门。

📚 课程目录