不同的安装脚本
标准的setup.py脚本接收几个参数,例如,安装到一个不要管理员权限的位置。它也用来生成不同发布包。运行python setup.py --help 查看更多地细节。
Robot Framework 还有一个支持安装和卸载的自定义的install.py 脚本。不带这个参数运行脚本可以看到更详细的细节。
使用Windows 安装程序
有单独的Windows 32 位和64 位的图形界面安装程序。前一种形式的安装程序的名字格式是robotframework-<version>.win32.exe, 后一种格式是robotframework-<version>.win-amd64.exe,这两种安装程序都可以在下载页找到。运行这个安装程序需要双击并依据简单的指示。
Windows 安装程序只用Python并且生成标准的pybot 和rebot 脚本。 和其他的安装程序不一样,这些安装程序还自动生成jybot 和ipybot 脚本。为了能使用这些脚本,Scripts 目录和合适的解释器需哟被加到PATH中。
注意
强烈建议在安装Robot Framework之前把Python安装目录设置到PATH 里。
注意
如果你安装了多个版本的Python或者解释器,执行的脚本永远是用在PATH 里最先找到的那个,不管那个脚本是用哪个版本的Python 安装的。为了避免这种情况,你可以永远加上解释器目录比如c:\Python25\python.exe -m robot.run。
注意
在Windows Vista 和Windows 7上,安装Robot Framework 需要管理员权限。启动安装程序的时候选择以管理员身份执行安装。
Python 包管理器
现在Python 有多种优秀的包管理器用来安装和管理Python 包。最著名的是easy_install和pip。我们强烈建议pip,因为它有积极地开发者和好用的功能,比如对卸载的支持。
不同的包管理器用法不同,但是和pip 和easy_install 的基本用法是相似的:
# Install the latest version
pip install robotframework
easy_install robotframework
# Upgrade to the latest version
pip install --upgrade robotframework
easy_install --upgrade robotframework
# Install a specific version
pip install robotframework==2.7.1
easy_install robotframework==2.7.1
# Uninstall -- only supported by pip
pip uninstall robotframework
小贴士
如果你需要proxy 连接互联网,pip 和easy_install 可以用http_proxy 环境变量。除此之外,pip 还支持 --proxy 命令行选项。
注意
pip 和easy_install 都有一个“特点”就是除非指明了版本,它们安装最新的可能版本,即使那是一个alpha 或者beta 版本。比如2.7.2 是最新的稳定版,但还有一个2.8 beta版,运行pip install robotframework 将会安装后一个版本。一种方法是明确指定版本号,比如pip install robotframework==2.7.2。
注意
只有Robot Framework 2.7和更新的版本支持pip。
使用一键安装
一键安装程序可以安装Robot Framework 和前提条件Python 和Jython(可选)。它还会自动地把Robot Framework脚本和Python及Jython 的可执行程序加到PATH。
一键安装程序需要你把所有需要的安装程序单独下载下来并把它们放在和它同一个目录下。等详细的说明和支持的安装程序可以在一键安装程序的wiki 页面查到。
注意
一键安装程序只能在Windows XP(32位)上工作。
注意
你应该只有在你没有安装Python 或 Jython 的情况下使用一键安装程序。
单独的JAR 发布版
Robot Framework还以单独的Java 包发布,这个包里面包含了 Jython 和 Robot Framework,并且只需要 Java 5 或更新版本。把所有东西放在一个包里且不需要安装时非常方便的方法,但是也有一个缺点就是不能支持Python。
这个包的名字形如robotframework-<version>.jar,在下载页可以找到。下载这个包之后,可以按如下的方式执行测试:
java -jar robotframework-2.7.jar mytests.txt
java -jar robotframework-2.7.jar --variable name:value mytests.txt
如果你想在运行后处理输出或者使用内建的工具。你需要给出命令名(比如rebot 或 libdoc)作为JAR 文件的第一个参数:
java -jar robotframework-2.7.jar rebot output.xml
java -jar robotframework-2.7.jar libdoc MyLibrary list
不加任何参数执行JAR 文件可以查看更多的关于不同命令的信息。
手工安装
如果不想使用任一个自动安装Robot Framework的方法,你总可以按照以下的步骤手动安装:
- 获取源代码。所有的代码都在一个叫做robot 的目录(Python中的一个模块)下。如果你有源发布,或者check out 了一个版本,你可以在src 目录下看到。你也可以从之前的安装中得到。
- 拷贝源代码到你想要的地方。
- 创建你需要的执行脚本或者使用你选择的解释器的目录入口点。
文件安装在哪里
当使用自动安装的时候, Robot Framework 源代码被复制到包含外部申明的 Python 模块所在的目录下。手动安装位置根据平台各不相同,但是像 UNIX 一类的操作系统,通常是在/usr/lib/[PythonVer]/site-packages 这样的目录下,在 windows 一类操作系统上一般是在[PythonInstallationDir]\Lib\site-packages 这样的目录下。手动 安 装 的 Robot Framework 源代码在名为 robot 的目录下 , 当采用 easy_install 的时候在robotframework[RobotVer].py[PythonVer].egg/robot 目录下。
Robot Framework 运行脚本生成后被拷贝到一个与平台有关的路径下。在类UNIX系统上,通常是 /usr/bin 。在 Windows和其它解释器上,脚本通常在解释器安装目录的Scripts 或 bin 目录下。