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檔,我們可以到官網下載。
  • 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常用的參數,我會在另外一篇文章告訴大家!

友藏內心的獨白:建立一個完美自動化的測試環境不是那麼容易滴~