如何在Katalon Studio的测试用例层级调用自定义关键字？

以下是排查和解决的具体步骤：

1. 检查自定义关键字的基础配置 #

• 必须把关键字类放在项目的Keywords目录下，Katalon只识别这个目录下的类作为自定义关键字
• 类中的方法必须添加@Keyword注解，示例代码：

  import com.kms.katalon.core.annotation.Keyword
  
  class CustomActions {
      @Keyword
      def clickElementWithWait(TestObject obj) {
          WebUI.waitForElementVisible(obj, 10)
          WebUI.click(obj)
      }
  }
  

• 写完关键字后保存，重启Katalon刷新关键字列表

2. 确认测试用例与关键字的语言匹配 #

• 如果关键字用Groovy编写，测试用例要选择Groovy语言；Java关键字对应Java用例
• 在测试用例的「Script」标签顶部可以看到语言对应的导入语句，比如Groovy会有import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI

3. 修正关键字调用语法 #

• 正确的调用格式是关键字类名.方法名(参数)，比如调用上面的示例方法：

  CustomActions.clickElementWithWait(findTestObject('Page_Home/btn_Submit'))
  

• 注意参数类型要和关键字方法定义的一致，避免类型不匹配报错

4. 修复项目索引问题 #

• 点击菜单栏「Project」→「Clean」清理项目索引，之后重新加载项目
• 如果项目的.classpath或.project文件损坏，可尝试新建项目，将原关键字和测试用例迁移过去

5. 排查版本兼容性 #

• 确保Katalon Studio版本支持当前关键字的语法，比如部分旧版本对注解的处理存在bug
• 尝试升级到最新稳定版，或者回退到之前能正常使用的版本

内容的提问来源于stack exchange，提问作者Madden Crush