日志

  • gauge 日志创建在项目中的logs目录下

  • 两个日志文件被创建

    • gauge.log - 测试执行日志
    • api.log - 用于gauge插件核心api的日志
  • 为自定义日志目录,设置 env/default/default.properties 文件内的 log_direcrory 属性为自定义日志目录路径

logs_directory = my_logs_dir

  • 对于非项目特定的操作,如插件安装日志在以下位置创建:
  • Windows - %APPDATA%\gauge\logs
  • MacOS* - < user_home >/.gauge/logs
  • Linux - < user_home >/.gauge/logs
    !– more –>

    Gauge安装

Windows

  • 默认安装位置是 %ProgramFiles%\gauge
  • 从命令行执行,应该添加 gauge_install_location\bin 到PATH
  • Gauge插件全部安装在 %APPDATA%\gauge\plugins 目录
  • APPDATA目录通常位于 C:\Users\USER_NAME\AppData\Roaming

Mac OS X

  • 默认安装位置是 /usr/local/
  • usr/local/bin/custom_install_location/bin 应添加到PATH
  • 在安装最新版本gauge之前执行 brew update
  • 如果安装失败升级homebrew
  • Gauge插件安装在 ~/.gauge/plugins 目录

Linux

  • 默认安装位置是 /usr/local/
  • usr/local/bin/custom_install_location/bin 应添加到PATH
  • Gauge插件安装在 ~/.gauge/plugins 目录

插件安装

  • 如果因为网络连接问题导致的插件安装失败,您可以手动下载zip文件,然后通过 -f 标志来安装。

gauge install plugin_name -f path_to_zip_file

例如:

gauge install html-report -f html-report-1.0.3-darwin.x86.zip

  • 从插件githun仓库的 Release 部分找到插件zip文件。在 gauge插件列表 查看更多插件仓库细节。

插件目录

插件都是安装在用户的home路径的 .gauge/plugins 目录 。您可以检查此目录来手动安装/卸载插件以及验证已安装的插件。

不同操作系统的插件安装目录如下:

  • Windows: %APPDATA%\.gauge\plugins
  • Mac OS X: ~/.gauge/plugins
  • Linux: ~/.gauge/plugins

自定义插件安装路径

默认情况下,插件在windows下安装在 %APPDATA%\gauge\plugins ,在mac和linux安装在 ~/.gauge/plugins

为安装插件在别的路径,设置环境变量 GAUGE_HOME 为自定义路径。在设置完 GAUGE_HOME 环境变量后,运行安装命令。插件将安装
GAUGE_HOME 的自定义路径。

自定义插件安装路径

执行

建议使用最新版本的gauge和gauge插件。请参阅我们的 [ 下载页面 ](http://getgauge.io/get-
started/index.html) 获取最新安装的链接。

验证错误

[WARN] Validation failed. The following steps have errors

如果针对特定步骤没有找到步骤实现,则通常会发生这些情况。

  • 确保步骤的 步骤实现 已经被添加
  • 标记代码中步骤的 步骤模版 区分大小写,并且应与specs文件中的步骤使用情况相匹配。

兼容性错误

Failed to start a runner. Compatible runner version to 0.0.7 not found

  • 安装的语言插件与gauge版本不兼容
  • 运行 gauge install language_NAME 安装最新兼容版本。更多细节参考 插件安装

执行错误

Error: too many open files

当打开文件数量的上限太低时,会出现此错误。要修复错误,请通过将命令 ulimit -S -n 2048 添加到 ~/.profile
文件并重新登陆来增加上限。

intellij idea插件

建议使用最新版本的 gauge intellij-gauge

intellij idea错误

Gauge API错误

Could not start gauge api: Could not find executable in PATH or GAUGE_ROOT.
Gauge is not installed.

因为下面的原因会使得错误发生:

  • Gauge没有安装
  • Gauge安装在自定义路径,但是 custom_install_location/bin 没添加到PATH

为解决此:

  • 如果gauge未安装, 安装它
  • 如果gauge安装在自定义路径,将 custom_install_location/bin 没添加到PATH
  • 在自定义安装路径,设置 GAUGE_ROOTcustom_install_location
  • 重启intellij

步骤标记未实现

如果步骤已编写实现代码,但是依然被标记为未实现。

  • 确保 src/test/java 目录在项目中已标记为测试源的根目录。右键点击 src/test/java 目录然后选择 Mark Directory as -> Test sources root
  • 确保项目已编译。按下ctrl/cmd+F9来构建项目或者选择 Build->Mark project
  • 确保已设置 Module SDKModule setting 下的有效SDK
  • 重启Intellij或者关闭再重开一个项目

检查依赖项

Gauge Maven项目

  • gauge-java依赖应被添加到pom.xml文件内
  • 确保项目自动引入。在 File > Settings > Maven > Importing 中 ,选中勾选框 Import Maven projects automatically

简单的gauge java项目

  • Project Settings -> Modules 选择gauge模块。在 depondencies 选项下应该是 gauge-libproject-lib
  • 如果没有生效,重启intellij或者关闭再重开项目。然后它们应该被添加上了。

项目编译失败,编译错误但java文件不标记任何错误

  • 项目编译失败,但是java文件不会在文件中标记任何错误
  • 这是在windows上的Java <=1.7的特别问题
  • IDEA安装目录/bin/idea.exe.vmoptions 文件中设置 -Duser.home=USER_HOME 来解决它

-Duser.home=C:\Users< username >