Gauge中文文档(1)—安装

英文原文地址:点击这里

翻译:amoschen

时间:2017/08/28

翻译基于原文0.9.1版本，有任何异议以及错误请指正。

Gauge简介

Gauge是一种轻量级的跨平台测试自动化工具，可以以业务语言编写测试用例。

下面是适用于所有OS的推荐安装步骤

Windows

根据您的系统配置下载安装包并运行它，选择您自己的安装方式直到询问您选择您的语言。

Gauge被默认安装在%PROGRAMFILES%，但是你可以自定义安装路径来完成安装。

MacOS

下列的命令来安装Gauge

想要它工作，你需要安装homebrew（译者注:Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令，就可以实现包管理，而不用你关心各种依赖和文件路径的情况，十分方便快捷。）。如果您已经安装了brew您只需要执行下面的指令；这样会下载和安装Gauge。这需要电脑连接到网络。

>brew update
>brew install gauge

Linux

下载ZIP文件，选择适合您安装的存档文件。然后执行下面的命令来安装Gauge。

>unzip gauge-$VERSION-$OS.$ARCH.zip
>./install.sh

Gauge插件也可以同gauge一起安装（需要联网）。设置GAUGE_PLUGINS（逗号分格的插件列表）环境来安装插件。

例如:

>GAUGE_PLUGINS=java,xml-report ./install.sh

有任何安装上的问题? 移步到安装常见问题列表。

替代方法

Windows

使用Chocolatey

你也可以通过使用Chocolatey（译者注：Chocolatey就是Windows系统的yum或apt-get）来安装Gauge。

>choco install gauge

如果想升级最新版本，使用下面的命令:

>choco upgrade gauge

MacOS

离线安装（pkg安装包）

您可以下载Gauge安装包，它是一个pkg文件，然后你可以选择您的安装方式直到安装结束。

点击Language runner来安装language runner插件。

Linux

On Debian, Ubuntu

Setup

添加Gauge的GPG key（译者注：应该是指加解密用到的密钥）

>sudo apt-key adv --keyserver hkp://pool.sks-keyservers.net --recv-keys 023EDB0B

Stable

对于稳定版本，请运行此命令将URL添加到存储库列表:

>echo deb https://dl.bintray.com/gauge/gauge-deb stable main | sudo tee -a /etc/apt/sources.list

Nightly

Nightly版本是Gauge的最新开发快照，他们有最新的功能开发，但不稳定。如果你想尝试Gauge的Nightly版本，请执行以下操作:

>echo deb https://dl.bintray.com/gauge/gauge-deb nightly main | sudo tee -a /etc/apt/sources.list

安装

>sudo apt-get update
>sudo apt-get install gauge

On RHEL, Fedora, CentOS

Setup

(译者注：原文这一小节也没有内容)

Stable

对于稳定版本，创建文件/etc/yum.repos.d/gauge-stable.repo并添加下面的内容：

[gauge-stable]
name=gauge-stable
baseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-stable
gpgcheck=0
enabled=1

您也可以使用下面的命令一步完成它：

>echo -e "[gauge-stable]\nname=gauge-stable\nbaseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-stable\ngpgcheck=0\nenabled=1" | sudo tee /etc/yum.repos.d/gauge-stable.repo

Nightly

备注：Nightly版本是最新的开发快照并且不稳定（译者注：虽然有些啰嗦，前面已经提过，但是看的出来文档编写者比较严谨）。

对于Nightly版本，创建文件/etc/yum.repos.d/gauge-nightly.repo并添加下面的内容：

[gauge-nightly]
name=gauge-nightly
baseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-nightly
gpgcheck=0
enabled=1

您也可以使用下面的命令一步完成它：

echo -e "[gauge-nightly]\nname=gauge-nightly\nbaseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-nightly\ngpgcheck=0\nenabled=1" | sudo tee /etc/yum.repos.d/gauge-nightly.repo

安装

在Fedora上安装：

>sudo dnf install gauge

在CentOS/RHEL上安装:

>sudo yum install gauge

手动安装

下载ZIP文件，选择适合您安装的存档文件。然后执行下面的命令来安装Gauge。

>unzip gauge-$VERSION-$OS.$ARCH.zip
>./install.sh

有任何安装上的问题? 移步到安装常见问题列表

插件

Language runner

C#

>gauge install csharp

Java

>gauge install java

Ruby

>gauge install ruby

可以使用IDE创建项目并运行规范，在这个例子中，我们使用命令行选项。

报告插件

HTML报告

>gauge install html-report

XML报告

>gauge install xml-report

安装验证

您可以通过执行下面的命令来检查插件和Gauge内核版本：

>gauge version

如果上述命令展示了版本号，那么你的安装和初始化是成功的。您的输出将如下所示：

>Gauge version: <version number>

>Plugins
>-------
>plugin(<version number>)

您可以点击这里阅读更多关于插件的内容。

如果您已经有了Gauge且已经安装了language runner，然后请看如何创建一个Gauge项目。

卸载

警告

如果您打算移除Gauge和已安装的插件，首先请按照插件页面的步骤来。

为了卸载Gauge，执行下面的命令：

OS X/Linux

>rm -rf /usr/local/bin/gauge /usr/local/bin/gauge_screenshot ~/.gauge

如果Gauge安装在自定义位置，用户将不得不删除相应的文件/目录。

Windows

在Gauge安装位置执行可执行文件uninst.exe

有关Gauge安装位置的更多信息，请点击这里。

插件

插件可以通过使用子命令卸载，命令是：

gauge uninstall <plugin-id>

例如:

>gauge uninstall java

为卸载特定版本的插件，使用–version标志。

例如：

>gauge uninstall java --version 0.3.2

一、安装

二、快速开始

三、深入开始

四、Gauge使用

五、语法

六、插件

七、语言特点

八、报告

九、配置

十、故障处理

十一、项目实例

十二、怎么做?