跳到主要內容

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常用的參數,我會在另外一篇文章告訴大家!

留言

這個網誌中的熱門文章

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中,不可或缺的東西就是Unattended installation。以Unattended installation來說,我們可以選擇透過Installer的silent mode安裝,也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法,教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數,除了可以直接上官網搜尋Installation User Guide以外,也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多,以我們需求來說,我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =

How to install RIDE on Windows?

Introduction 多年沒在Windows上開發RobotFramework,趁著這次整理一下RIDE安裝方法。 目前RIDE最新版本與Python對應版本如下: (3.6 < python <= 3.11) Install current released version (2.0.8.1) with: pip install -U robotframework-ride 安裝Python 直接到Python官網找尋最新的3.11版本,我使用3.11.9: link 。安裝就是一直下一步而已。 安裝wxPython 每次安裝RIDE最困難的都是wxPython。看了一下 官網 描述,我就姑且相信一下: 接著進入下 載頁面 就有安裝教學。基本上就是到Python目錄下的Scripts直接執行以下command: pip install -U wxPython 安裝RIDE 接著就如RIDE官網所說,執行以下command: pip install -U robotframework-ride 啟動RIDE 直接在相同目錄下執行ride就可以啟動了,你也可以直接在桌面建ride連結,加快下次啟動時間。 沒想到這次這麼順利就安裝完成了。因為我是使用java去啟動robot framework,就不特別講要怎麼使用pip安裝robot framework了。

Hello World!

即將要搬家,因此舊網頁內容將慢慢轉移至Blogger。 如果要存取舊網頁,可以使用以下連結: https://wiki.tonylin.idv.tw/dokuwiki/doku.php