最新翻译(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
到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插件。请参阅我们的下载页面获取最新安装的链接。
验证错误
[WARN] Validation failed. The following steps have errors
…
如果针对特定步骤没有找到步骤实现,则通常会发生这些情况。
兼容性错误
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使用
五、语法
六、插件
七、语言特点
八、报告
九、配置
十、故障处理
十一、项目实例
十二、怎么做?