最新翻译(2020/12/1)已更新在个人博客：https://www.nothinghere.cn/gauge/overview/

日志

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

Gauge安装

Windows

默认安装位置是%ProgramFiles%\gauge从命令行执行，应该添加gauge_install_location\bin到PATHGauge插件全部安装在%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如果安装失败升级homebrewGauge插件安装在~/.gauge/plugins目录

Linux

默认安装位置是/usr/local/usr/local/bin/和custom_install_location/bin应添加到PATHGauge插件安装在~/.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\pluginsMac OS X: ~/.gauge/pluginsLinux: ~/.gauge/plugins

自定义插件安装路径

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

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

自定义插件安装路径

执行

建议使用最新版本的gauge和gauge插件。请参阅我们的下载页面获取最新安装的链接。

验证错误

[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_ROOT为custom_install_location重启intellij

步骤标记未实现

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

确保src/test/java目录在项目中已标记为测试源的根目录。右键点击src/test/java目录然后选择Mark Directory as -> Test sources root确保项目已编译。按下ctrl/cmd+F9来构建项目或者选择Build->Mark project确保已设置Module SDK为Module 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-lib和project-lib如果没有生效，重启intellij或者关闭再重开项目。然后它们应该被添加上了。

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

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

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

更多细节参阅Intellij idea论坛帖子

---

章节指引 一、安装 二、快速开始 三、深入开始 四、Gauge使用 五、语法 六、插件 七、语言特点 八、报告 九、配置 十、故障处理 十一、项目实例 十二、怎么做?