【CAPL】头文件的创建和使用

CAPL中的头文件的必要性

提高代码复用性

重用经过调试验证的代码：是提高测试软件开发效率的有效途径
为了增强CAPL代码的复用性，CAPL提供了*.cin文件（callback interface file）​，用户可以通过该文件搭建自定义的测试框架。

头文件常见的使用场景

比如，将基本的函数接口按照不同类型分别定义在各自的.cin文件中，然后再在不同的.can文件中包含所需要的.cin文件，从而形成二层引用结构。
同时也可以在.cin中包含其他的.cin文件，然后在.can文件中包含上层*.cin文件，进而形成多层的引用结构，从而达到提高代码复用效率的目的。

创建头文件

头文件的创建

• CAPL浏览器中：file-new-new CAPL include file
  

头文件的保存

• 直接保存 或 file-save as
• 保存位置：node文件夹下
  

头文件代码

注释是非常必要的

• 添加详细的代码描述：
  • 函数名，函数功能描述；
  • called/calls：被哪些文件引用；引用了哪些文件；
  • 参数和返回值；
  • 其他信息补充...
• 代码描述示例：
  

编译

• 在本代码文件中，编译按钮是灰的
• 头文件代码将在引用的文件中进行编译
  

引用头文件的代码

• 相对路径：..表示CANoe工程所在的路径
  
• 绝对路径：完整路径
• include部分加入头文件声明，否则报错
  

调用的大小写的差异

• 引用函数大小写不区分
  
• 但是！ 定义变量的大小写搞错会报错
  
  

头文件引用的易错点

• 首先，路径分割是左上右下的斜杠，与注释的斜杠区分

• 其次，头文件引用这句code的结尾是没有分号的！！！！！！加分号会报错！！！！

• 错误示范

  

• 正确示范

  

执行结果

• 

跳转到头文件指向的文件

• 选中-go to definition，可以打开指向的头文件文件
  

参考链接

• canoe手把手系列（十一）创建使用头文件

END