Robot Framework 中文用户指南 | 第一章第三节

  1. 云栖社区>
  2. 博客>
  3. 正文

Robot Framework 中文用户指南 | 第一章第三节

wywincl_wy 2016-12-15 11:02:00 浏览532
展开阅读全文

1.3 安装说明

本章的说明涵盖了所有Robot Framework安装和卸载的方法,以及在不同操作系统上安装的前提条件。如果你本地安装有pip,那么就很容易安装Robot Framework。如下:

    pip install robotframework 

1.3.1 介绍

Robot Framework是用Python实现的,同时支持Jython(JVM)和IronPython(.NET)。在安装框架之前,前提条件就是安装其中一种Python解释器。

下面列出了安装Robot Framework不同的方式,并在后续的章节中加以详细的说明。

用pip安装

pip安装Robot Framework是官方推荐的方式。在最新的Python, Jython和IronPython版本中已经包含了这种标准的包管理器。
如果你已经安装了pip, 你可以简单的执行以下这句命令:

    pip install robotframework

用源码安装

这种方式独立于操作系统和Python解释器。你可以从PyPI网站上下载源码发布包进行解[压亦或是从Github上克隆Robot Framework仓库。

独立的JAR发布包

如果你用Jython执行测试就足够的话,最简单的方式就是从Maven中央仓库上下载独立的JAR包robotframework-[version].jar
JAR发布包同时包含了Jython和Robot Framework,因此仅仅需要安装Java就可以了。

手动安装

如果你有特殊需求或者其他的方式都不起作用,那么你可以手动安装。

注意
在Robot Framework 3.0以前,也有Python 32位版本和64位版本两个单独的Windows安装程序。但是在Windows上自带pip的Python2.7.9和更新的版本以及Python 3则需要更多的安装程序。
因此我们决定不在提供Windows安装程序了。在Windows系统上我们同样推荐pip安装方式。

1.3.2 前提条件

Robot Framework支持Python(包括Python 2和Python 3), Jython(JVM), IronPython(.NET)以及PyPy.
在安装Robot Framework之前,必须先安装你选择的Python解释器。

一般来说,选择哪种解释器通常根据你的测试库和测试环境决定。一些测试库使用的工具和模块仅仅在Python下工作,而另一些测试库需要使用Java工具,这就需要有Jython环境,或者需要.NET环境,那就需要安装IronPython。
也有一些测试库和工具能够在所有解释器平台上正常运行。

如果你没有特殊的环境要求,那么推荐使用Python解释器来运行Robot Framework。因为Robot Framework是用原生Python实现的,所以运行的自然比Jython和IronPython要快(特别是在启动时间上)。
同时在类Unix系统上,Python解释器是自带的,随时可用。还有一个替代方案就是,运行独立的JAR发布包,它仅仅依赖Java环境作为前提条件。

Python 2 or Python 3

Python 2 和Python 3通常来说是同一种编程语言,但是它们之间却不是完全的相互兼容。两者之间主要的区别是Python 3中所有的字符串都是Unicode编码的,而在Python 2中默认是字节编码。
但是也有其他几个向后兼容的改变。最后一个Python 2版本是Python 2.7, 于2010年发布, 将会支持到2020年。点击链接Should I use Python 2 or 3?查看更多关于两者之间的异同,该使用哪个版本,
以及如何写出兼容两个版本的代码等等。

Robot Framework 3.0 是第一个支持Python 3的版本, 当然,它也支持Python 2版本。同时我们也计划一直支持到Python 2官方的结束支持时间。我们希望开发Robot Framework生态系统的测试库和测试工具的开发者能够考虑支持Python 3, 像我们的核心框架一样。

Python 安装

在大部分类Unix系统,如Linux和OS X已经默认自带了Python解释器了,所以无需安装。如果你是在Windows系统或者自己需要安装Python, 可以去官方网站http://python.org,这里可以下载合适的版本以及了解更多关于Python的相关信息。

Robot Framework 3.0支持Python 2.6, 2.7, 3.3和更新的版本。但是RF3.1 已经计划不支持Python 2.6了。如果你需要使用老版本Python的话,Robot Framework 2.5-2.8支持Python 2.5, Robot Framework 2.0-2.1 支持Python 2.3和2.4。

在安装完Python以后,你可能需要设置PATH环境变量, 以使Python本身以及robotrebot执行器能够在命令行中执行。

小贴士
最新的Python Windows安装程序在安装过程中允许设置PATH路径。这个功能默认是禁用的, 但可以通过在自定义安装Python界面中添加python.exe到Path中来启动。

Jython 安装

使用Java实现的测试库或者工具需要Robot Framework运行在Jython上。反过来又需要有Java运行时环境(JRE)或者Java开发工具集(JDK)。安装这两种Java发行包已经超出了本章的范围了,但是你可以通过http://java.com来获取更多信息。

安装Jython是很容易的,第一步就是在网站http://jython.org获取安装程序。安装程序是可执行的JAR包,可以在命令行中执行,如java -jar jython_installer-<version>.jar。依赖于系统设置,你或许可以通过双击文件来运行安装程序。

Robot Framework 3.0 支持Jython 2.7, 因此需要Java 7或更新的运行时环境。如果需要旧的Jython或者Java版本,那么Robot Framework 2.5-2.8支持Jython 2.5(需要Java 5以及更新版本);
Robot Framework 2.0-2.1支持Jython 2.2。

安装完Jyhton之后,你可能仍需要配置PATH环境变量,以使Jython本身以及robotrebot执行器能够在命令行中执行。

IronPython 安装

IronPython 运行Robot Framework运行在.NET平台,可以与C#或者其他.NET语言和API进行交互。仅支持IronPython 2.7。

当使用IronPython,需要额外安装elementtree模块1.2.7预览版本。这是因为elementtree模块利用IronPython发布出现了问题。
你可以下载源码安装包到本地,解压,然后在解压目录下打开终端,执行ipy setup.py install进行安装。

安装完IronPyhton之后,你可能仍需要配置PATH环境变量,以使Jython本身以及robotrebot执行器能够在命令行中执行。

配置PATH

PATH环境变量列出了操作系统执行命令的位置,为了确保可以从终端上执行Robot Framework, 推荐将Robot Framework的执行器路径添加到PATH环境变量中去。通常也将解释器本身添加到PATH中,以使Python执行方式更加简单。

当在类Unix系统使用Python时,Python本身和它的相关脚本会自动地添加到PATH路径中去,无需额外操作。但在Windows系统和其他解释器的情况下,还需要分别设置PATH环境变量。

小贴士
最新的Python Windows安装程序在安装过程中允许设置PATH路径。这个功能默认是禁用的, 但可以通过在自定义安装Python界面中添加python.exe到Path中来启动。
这样会同时将Python安装路径和脚本目录添加到PATH环境变量中去。

添加什么目录到PATH

添加什么目录到PATH环境变量中取决于你本地的操作系统和解释器类型。首要位置就是解释器的安装目录(如,C:\Python27),其次就是解释器安装执行脚本的目录。
在Windows系统上,Python和IronPython均将脚本安装到自身安装目录的Scripts子目录下。无论在什么系统上,Jython统一安装到bin目录下(如,C:\jython2.7.0\bin)。

注意Scripts和bin目录并不是在解释器自身安装的时候创建的,在安装Robot Framework和Python第三方模块的时候,才会创建该目录。

在Windows系统上配置PATH

在Windows系统上你可以根据以下步骤来配置PATH环境变量。注意具体的设置名称可能在不同的Windows版本上会出现不一致,但基本的方法是一样的。

  • 打开控制面板>系统>高级>环境变量。有系统环境变量和用户环境变量,它们的区别是用户环境变量仅仅对当前的用户生效,而系统环境变量则对所有的用户起作用。
  • 编辑已存在的PATH值,选择编辑,然后添加;<InstallationDir>;<ScriptsDir>到已存在的值的末尾去(如. ;C:\Python27;C:\Python27\Scripts)。
    注意分号(;)很重要, 它用于分隔不同的值项。添加一个新的PATH值,选择新增,然后同时设置变量名和值, 只一次前面不需要分号了。
  • 点击确定按钮,保存修改并退出对话框。
  • 启动新的命令行终端使修改生效。

注意,如果你的操作系统安装了多个版本的Python的话,执行robotrebot执行器命令的时候,会首先选择PATH变量中最靠前的命令路径来执行,而不管该命令安装在哪个Python版本中。
为了避免这种情况,你可以选择始终以直接执行robot模块的方式,如C:\Python27\python.exe -m robot

注意,你也不应该为添加到PATH环境变量中的路径加上双引号(如,"C:\Python27\Scripts"),双引号可能会在Python中引起一些问题。在设置PATH环境变量的路径值是也没必要添加双引号,即使路径中可能包含空格。

在类Unix系统上配置PATH

在类Unix系统上,你可能需要编辑系统层面或者用户层面的配置文件。至于编辑何种文件则依据于具体的操作系统。你需要查询操作系统文档来获取更多信息。

配置https_proxy

如果你是用pip安装,并且使用代理的话,你需要设置https_proxy环境变量。https_proxy环境变量在安装pip本身和使用pip安装Robot Framework以及其他Python包的时候都需要。

和配置PATH类似,配置https_proxy环境变量,根据不同的系统,方式也不尽相同。但是https_proxy变量的值必须是代理的URL地址,如http://10.0.0.42:8080。

1.3.3 用pip安装

Python标准的包管理方式是pip, 但是也有其他的替代方案如Buildouteasy_install
本节只覆盖了pip安装的部分,其他的包管理方式也能安装Robot Framework。

最新的Python, Jython和IronPython版本已经内置了pip模块。后续的章节我们详细讨论那些版本包含pip以及如何使用pip。如果你需要安装pip,可查看pip项目主页以了解最新的安装说明.

小贴士
只有Robot Framework 2.7和更新的版本可以用pip安装。如果你需要用旧的版本,你必须选择其他的安装方式。

为Python安装pip

从Python 2.7.9开始,标准的Windows安装程序就默认安装和激活了pip了。假设你已经设置好PATH或者HTTP代理了,你可以在安装完Python后执行命令
pip install robotframework

对于非Windows系统或者是早期的Python版本,你需要自己手动安装pip。你可以利用系统的包管理工具,在linux上使用apt或者是yum来进行安装。
同时你也可以在pip主页上找到手动安装的说明。

如果你安装有多个包含pip模块的Python版本的话,那么优先执行PATH环境变量中第一个在搜索路径发现的pip命令。一个替代的方式是直接在执行pip命令的时候选择Python的版本:

    python -m pip install robotframework
    python3 -m pip install robotframework

为Jython安装pip

Jython 2.7已经自带了pip,但是需要先执行下面的命令启用它:

    jython -m ensurepip

Jython将pip安装到<JythonInstallation>/bin目录下。
执行运行pip install robotframework有可能会使用其他的pip版本, 这取决于PATH环境变量中pip命令的路径地址顺序。
一个替代的方式是直接用Jython运行pip模块:

    jython -m pip install robotframework

为IronPython安装pip

IronPython 从2.7.5版本开始自带pip。和Jython类似,需要先进行激活:

    ipy -X:Frames -m ensurepip

注意命令行选项 -X:Frames在激活和使用pip的时候都需要。

IronPython将pip安装到<IronPythonInstallation>/Scripts目录下。
执行运行pip install robotframework有可能会使用其他的pip版本, 这取决于PATH环境变量中pip命令的路径地址顺序。
一个替代的方式是直接用IronPthon运行pip模块:

    ipy -X:Frames -m pip install robotframework

IronPython 2.7.5以前的版本,官方不支持pip。

使用pip

一旦安装好了pip,设置好https代理以后,在命令行使用pip就非常简单了。最简单的方式就是使用pip从Python Package Index (PyPI)上来查找和下载包。
它也可以安装已经下载的安装包。最常用的使用方法如下所示,pip官方文档提供了更多详细的信息:

    # Install the latest version
    pip install robotframework

    # Upgrade to the latest version
    pip install -upgrade robotframework

    # Install a specific version 
    pip install robotframework==2.9.2

    # Install separately downloaded package (no network connection needed.)
    pip install robotframework-3.0.tar.gz

    # Uninstall
    pip uninstall robotframework

注意pip1.4和更新的pip版本默认情况下只会安装稳定的包版本。如果你需要安装alpha,beta或者rc版本,你需要特别指定,或者使用--pre选项。

    # Install 3.0 beta 1
    pip install robotframework==3.0b1

    # Upgrade to the latest version even if it is a pre-release
    pip install --pre --upgrade robotframework

1.3.4 用源码安装

这种安装方法可以在所有系统和解释器环境下使用。从源码安装可能有一点可怕,但是过程其实是非常简单明了的。

获取源码

你通常可以下载.tar.gz格式的源码发布包来获取源码。在PyPI上可以获取更新的包。
但是Robot Framework 2.8.1和更早的版本只能从旧的Google Code下载页面获取了。
一旦你下载了源码包以后,你就需要解压到某个路径,完成后,创建了目录为robotframework-<verion>。这个目录包含了安装的源码和脚本。

另一种获取源码的方式是直接从Github仓库中克隆该项目。
默认情况下,获取的是最新的代码, 但是你可以很容易切换到不同的发布版本和Tag标签。

安装

Robot Framework源码安装是采用标准的Python setup.py安装脚本。安装脚本在解压后的源码目录中, 你可以在命令行下使用任意一种解释器进行安装:

    python setup.py install 
    jython setup.py install
    ipy setup.py install

setup.py安装脚本允许接收多个参数。例如,安装到非默认路径不需要管理员权限。它也可以用于创建不同的发行包。
执行python setup.py --help来获取更多信息。

1.3.5 独立的JAR发行包

Robot Framework也提供了独立的JAR发行包,包含了Jython和Robot Framework,仅仅依赖Java环境。这种方式不需要进行安装,只需要一个包就可以了。
但是一个缺点就是在通常的Python解释器下不能工作。

这个包的命名是robotframework-<version>.jar, 在Maven中央仓库上可以获得。
下载完包以后,你可以以下的方式执行测试:

    java -jar robotframework-3.0.jar mytests.robot
    java -jar robotframework-3.0.jar --variable name:value mytests.robot

如果你想使用后处理命令或者使用其他内置工具的话,你需要将命令名作为第一个参数传递给JAR文件:

    java -jar robotframework-3.0.jar rebot output.xml
    java -jar robotframework-3.0.jar libdoc MyLibrary list

可以通过不带任何参数执行JAR文件来获取更多信息。

除了Python标准库和Robot Framework模块外,这个独立的JAR发行包从2.9.2版本开始,也包含了依赖项PyYAML来处理yaml格式的变量文件。

1.3.6 手动安装

如果你不想采用任何自动化的方式来安装Robot Framework的话,你也可以按照以下步骤来手动安装:

  • 获取源码, 所有的源码在robot目录下, 如果你从源码发布或者版本控制系统检出的话,你可以从src目录找到源码, 你也可以从早先安装路径制获取源码。
  • 拷贝源码到你想要的路径。
  • 按照自己的方式执行测试。

1.3.7 验证安装

在成功安装以后,可以通过在命令行中终端上用--version选项来运行执行器去获取Robot Framework版本以及Python解释器版本:

    $robot --version
    Robot Framework 3.0 (Python 2.7.10 on linux2)

    $rebot --version
    Rebot 3.0 (Python 2.7.10 on linux2)

如果运行执行器脚本失败的话,提示错误信息是命令没找到或者不识别的话,最好先检查一下PATH环境变量是否配置正确。如果PATH没有问题的话,
再去阅读相关章节的说明, 如果还是没有解决的话,可以通过因特网或者是robotframework-users邮件组等方式来寻求帮助。

1.3.8 卸载

最简单的卸载Robot Framework的方式就是使用pip命令:

    pip uninstall robotframework

用pip卸载的好处就是即使你是用源码安装的,也同样可以卸载。如果你没有安装pip的话,或者是手动安装到自定义的路径,那么你需要知道你的文件安装到哪里,然后手动删除它们。

如果你在PATH环境变量中设置了相关路径,你需要撤销这些操作。

1.3.9 升级

如果你使用pip的话,升级新版本,可以使用参数--upgrade选项或者是指定的版本:

    pip install --upgrade robotframework
    pip install -U robotframework
    pip install robotframework==2.9.2

但使用pip安装时,它会自动卸载先前安装的版本。如果你是源码安装的话,覆盖安装通常也是安全的。
如若遇到了问题,请再安装之前先卸载旧的版本可能会解决。

当升级Robot Framework时,可能会遇到新版本对旧版本不兼容的情况,从而影响到已存在的测试或者是测试设施。但是这些问题在临近的小版本之间影响微乎其微,
如2.8.7或2.9.2, 而在大版本之间如2.9和3.0之间可能会比较常见。向后不兼容的影响以及不推荐的特性在发行说明中已经详细说明了。
在升级到新的里程碑版本的时候,了解它的新特性和一些改变会是很好的方式。

1.3.10 执行Robot Framework

使用robotrebot脚本

从Robot Framework 3.0开始,用脚本命令robot来执行测试,用rebot脚本来执行结果的后处理。

    robot tests.robot
    rebot output.xml

这两个脚本命令都是随着Robot Framework安装程序一起被安装的。如果PATH配置正确的话,可以直接从命令行终端上执行。
它们是用Python实现的,但是在Windows上,它们是批处理脚本。

旧的Robot Framework版本不含robot命令,而rebot命令只在Python解释器中。
在其他解释器中替代的是pybotjybot, ipybot来执行测试, jyrebot, ipyrebot来处理结果。这些脚本目前仍然可以运行,但是不推荐使用,不排除在将来会将它们移除。

执行已安装的robot模块

还有一种替代的方式运行测试是用Python的-m command line option命令行方式直接执行robot模块或者其子模块robot.run
这种方式在多版本Python并存的环境中很有用。

    python -m robot tests.robot
    python3 -m robot.run tests.robot
    jython -m robot tests.robot
    /opt/jython/jython -m robot tests.robot

python -m robot方式的支持是Robot Framework 3.0的新功能,在旧的版本中只支持python -m robot.run。后者必须在Python 2.6的环境下运行。

结果后处理使用相同的方式。模块改为robot.rebot

    python -m robot.rebot output.xml

执行已安装的robot目录

如果你知道robot安装目录的话,你可以在安装目录中直接执行robot命令或者是run.py文件:

    python path/to/robot/ tests.robot
    jython path/to/robot/run.py tests.robot

执行robot目录是Robot Framework 3.0的新功能。旧版本功能仅仅支持执行robot/run.py文件。

结果后处理使用同样的方式robot/rebot.py执行:

    python path/to/robot/rebot.py output.xml

如果你是手动安装的,这种执行方式非常方便。

网友评论

登录后评论
0/500
评论
wywincl_wy
+ 关注