How to build portable robot-package?

前言

要建立一個robot的環境，需要python(或jython)、robot framework，如果要測Web，又需要robotframework-selenium。不管是部屬新的測試機，還是弄IDE環境，如果有一個預先弄好的測試安裝包，那不是可以節省很多時間? 今天要教你的，就是如何去建立一個robot測試安裝包。

準備

如果你希望你的測試環境包含了linux與windows，並且有x86與x64平台，使用jython是最方便且簡單的方法。你需要以下東西:

• robotframework with jython: robot-framework提供了與jython整合的jar檔，我們可以到Maven下載。(因為jython支援度的關係，目前最只支援到4.1.2)
• robotframework-selenium: 我們可以到robotframework-seleniumlibrary官網下載原始碼包。
• JRE:要能夠執行jython，就需要jre。由於希望能夠支援linux與windows，還有x86與x64平台，windows部分我準備了32位元的jre，linux部分則分別準備了32與64的jre。像RHEL6預設並不會安裝32位元的函式庫，測試環境也應該要夠乾淨，面對這種情況就需要使用64位元的jre。

準備好的package如下圖所示:

包裝

我們可以手動將JRE、robot jar檔與建立一個Lib資料夾放selenium libraries，透過java -jar robotframework.jar run test.html，就能開始測試。但我選擇透過ant去自動產生windows與linux各platform的package。即使是各package更新，一樣能快速修改，ant內容如下(ant達人們請別太挑我的script)：

<?xml version="1.0" encoding="UTF-8"?>
<project name="PortableRobotFramework" basedir="." default="default">
	<!-- artifact info -->
	<property name="robotframework" value="robotframework-2.7b1.jar" />
	<property name="linux-jre-x64.dir" value="jre1.6.0_31_x64"/>
	<property name="linux-jre-x86.dir" value="jre1.6.0_31_i586"/>
	<property name="win-jre" value="win-jre6-x86.zip" />
	<property name="robotframework-selenium.package.dir" value="robotframework-seleniumlibrary-2.8.1" />
	<property name="robotframework-selenium" value="${robotframework-selenium.package.dir}.tar.gz" />
	<property name="linux-jre-x64" value="${linux-jre-x64.dir}.tar.gz" />
	<property name="linux-jre-x86" value="${linux-jre-x86.dir}.tar.gz" />
 
	<property name="build.dir" value="${basedir}/build" />
	<property name="dist.dir" value="${basedir}/dist" />
	<property name="packages.dir" value="${basedir}/packages" />
	<property name="packages.jre.dir" value="${packages.dir}/jre" />
	<property name="build.common.dir" value="${build.dir}/common-package" />
	<property name="build.common.libs.dir" value="${build.common.dir}/Lib" />
	<property name="build.selenium.dir" value="${build.dir}/${robotframework-selenium.package.dir}" />
 
	<property name="rfs.tar.file" value="${packages.dir}/${robotframework-selenium}" />
	<property name="rf.jar.file" value="${packages.dir}/${robotframework}" />
	<property name="jre.linux.x86.tar.file" value="${packages.jre.dir}/${linux-jre-x86}" />
	<property name="jre.linux.x64.tar.file" value="${packages.jre.dir}/${linux-jre-x64}" />
	<property name="jre.win.x86.zip.file" value="${packages.jre.dir}/${win-jre}" />
 
	<target name="default">
		<antcall target="clear" />
		<antcall target="prepare" />
		<antcall target="package" />
		<delete dir="${build.dir}" />
	</target>
 
	<target name="clear">
		<delete dir="${build.dir}" />
		<delete dir="${dist.dir}" />
	</target>
 
	<target name="prepare">
		<mkdir dir="${build.dir}" />
		<mkdir dir="${dist.dir}" />
		<mkdir dir="${build.common.dir}" />
		<untar compression="gzip" src="${rfs.tar.file}" dest="${build.dir}" />
		<untar compression="gzip" src="${jre.linux.x86.tar.file}" dest="${build.dir}" />
		<untar compression="gzip" src="${jre.linux.x64.tar.file}" dest="${build.dir}" />
		<unzip src="${jre.win.x86.zip.file}" dest="${build.dir}" />
 
		<antcall target="create common folder" />
	</target>
 
	<target name="create common folder">
		<copy tofile="${build.common.dir}/robotframework.jar" file="${rf.jar.file}" />
		<mkdir dir="${build.common.libs.dir}" />
		<copy todir="${build.common.libs.dir}">
			<fileset dir="${build.selenium.dir}/src" />
		</copy>
	</target>
 
	<target name="package">
		<antcall target="package windows" />
		<antcall target="package linux">
			<param name="jre.package.name" value="${linux-jre-x86.dir}" />
			<param name="package.name" value="linux-x86-portable-robotframework"/>
		</antcall>
		<antcall target="package linux">
			<param name="jre.package.name" value="${linux-jre-x64.dir}" />
			<param name="package.name" value="linux-x64-portable-robotframework" />
		</antcall>
	</target>
 
	<target name="package linux">
		<copy todir="${build.dir}/${package.name}">
			<fileset dir="${build.common.dir}" />
		</copy>
		<move todir="${build.dir}/${package.name}/jre" failonerror="false">
			<fileset dir="${build.dir}/${jre.package.name}" />
		</move>
		<tar destfile="${dist.dir}/${package.name}.tar.gz" compression="gzip">
			<tarfileset dir="${build.dir}">
				<include name="${package.name}"/>
				<include name="${package.name}/**"/>
				<exclude name="${package.name}/jre/bin/java"/>
			</tarfileset>
			<tarfileset dir="${build.dir}" mode="755">
				<include name="${package.name}/jre/bin/java"/>
			</tarfileset>
		</tar>
	</target>
 
	<target name="package windows">
		<copy todir="${build.dir}/win-portable-robotframework">
			<fileset dir="${build.common.dir}" />
		</copy>
		<move todir="${build.dir}/win-portable-robotframework/jre" failonerror="false">
			<fileset dir="${build.dir}/jre6" />
		</move>
		<zip destfile="${dist.dir}/win-portable-robotframework.zip" basedir="${build.dir}">
			<include name="win-portable-robotframework" />
			<include name="win-portable-robotframework/**" />
		</zip>
	</target>
</project>

建置結果如下圖所示，windows上產生一個zip檔案，linux上分別產生x86與x64的tar.gz檔。

第一個測試

首先自己寫一個簡單的robot測試。這裡是使用firefox當測試瀏覽器，如果在windows上使用，請記得將firefox.exe加到系統變數中。我的環境是RHEL5.6並使用linux-x64-portable-robotframework.tar.gz測試包。首先我們輸入./jre/bin/java robotframework.jar –help看看是否能夠成功執行：

輸入./jre/bin/java robotframework.jar run ./test.html 來執行測試：

我在這唯一有遇到的問題是: RHEL原先的open jdk，執行jython會有些問題。另外在測試時必須將./jre/bin/java加到path中，因為robotframework在啟動selenium server是直接透過java指令的!

其它

這篇文章中僅教你如何做robot測試安裝包，要能夠隨身攜帶的測試包，內容還需要包含testcases的下載、執行的script與瀏覽器等。此外，如果是要部署到測試機上的，還要考量測試工具如何自動更新。這些做的好就能夠解省時間成本，之後有時間我再整理一下分享給大家。robotframework.jar常用的參數，我會在另外一篇文章告訴大家!