robot framework安装和使用

Robot Framework +Appium的简单教程

RF+Appium介绍

网上文章较多，不做赘述

Robot Framework

Appium

RF 的安装和配置

在使用RF（Rebot framework）的时候需要Python 或Jython 环境，具体可根据自己的需求来确定。本文以在有Python 的环境的机器上安装和使用RF 为例。

在配置过程中需要安装如下包：python 2.7、wxPython、robot framework、robot framework ride、robot framework selenium library。

安装Python 2.7

RF 框架是基于Python 语言的，所以一定要有Python 环境。可以通过下面的下载页面下载对应的Python 版本。

下载页面：https://https://www.360docs.net/doc/8f8939249.html,/downloads/。

下载完成后，选择默认项进行安装

安装完后，需要设置环境变量：计算机—属性—高级系统设置—环境变量—系统变量—Path，写入C:\Python27 和C:\Python27\Scripts（更改为您指定路径即可）。

同时我们也可以通过DOS 环境来验证安装的Python 信息。

安装WxPython

下载页面： https://www.360docs.net/doc/8f8939249.html,/download.php#stable。

在选择版本下载的时候要注意选择与Python 版本对应的版本，并且选择unicode 版本，比如版本：wxPython2.8-win32-unicode-py26.exe，否则安装完成后不能支持中文。

下载完成后，选择默认项进行安装即可。

https://https://www.360docs.net/doc/8f8939249.html,/projects/wxpython/files/wxPython/2.8.12.1/

安装PyCrypto

下载页面：https://www.360docs.net/doc/8f8939249.html,/python/modules.shtml#pycrypto。

选择对应的pycrypto installer 版本，进行默认安装。需要在安装库（如SHHLibrary）之前进行安装，否则会出现错误“Can't find vcvarsal.bat”。

安装Robot Framwork

进入Python 的安装路径，执行命令“pip install robotframework”或者通过下载页面 https://https://www.360docs.net/doc/8f8939249.html,/pypi/robotframework下载源码。

解压后，执行命令“python setup.py install”进行安装。进入Python 的安装路径，执行命令“pip install robotframework”。

pip install robotframework

easy_install robotframework （3.0）

安装robotframework-ride

进入Python 的安装路径，执行命令“pip install robotframework-ride”。

安装需要的Library

如

selenium2library ,

appiumlibrary，

https://https://www.360docs.net/doc/8f8939249.html,/pypi/robotframework-appiumlibrary

archivelibrary,SSHLibrary ,ftplibrary 等。进入Python 的安装路径，分别执行以下命令：清单1. 安装Test Library

pip install robotframework-selenium2library

pip install robotframework-archivelibrary

pip install robotframework-SSHLibrary

ip install robotframework-ftplibrary

如果pip install不行就用easy_install

安装和配置appium

官网下载，或者百度下载appium的windows安装包

官网：https://https://www.360docs.net/doc/8f8939249.html,/appium/appium.app/downloads/

打开appium，如图所示配置，最后一步点击Launch打开Appium Socket Server

完成以上步骤后，RobotFramework+Appium 的安装和配置工作已经完成，可以通过执行命令“pip list”查看已经安装的产品，如图1 所示：

图1.RobotFramework 安装产品列表

RIDE 编辑器介绍

打开RIDE

RF 是通过RIDE 编辑器进行工作的，安装成功后，执行命令“[PythonDir]\Scripts\ride.py”，就可以打开RIDE 编辑器，如图2 所示。打开之后就可以进行创建测试项目，创建测试用例等操作，在后面的实例讲解中有具体步骤。

图2.RIDE 编辑器启动界面

创建测试项目

选择菜单栏File —>New Project，输入项目名称，选择Directory type，选择目录。

图3. 创建测试项目

创建测试套件

右键点击刚创建的测试项目，选择New Suit，输入name , 选择File type。

图4. 创建测试套件

创建测试用例

右键点击刚创建的测试套件，选择New TestCase，输入名称。

图5. 创建测试用例

导入库

在实际项目中，我们需要运用RF 框架编写基于web 的测试用例，我们需要Selenium 的库支持。所以，我们在使用的过程中需要加载selenium2library 库。

图6. 导入测试库

在“测试套件”的Edit 标签页，点击“Library”按钮，弹出输入框，Name 输入：AppiumLibrary，点击OK 完成。

如果导入的库显示为红色，表示导入的库不存在。如果是黑色则表示导入成功。

编写测试用例

可以通过快捷键F5 来查询脚本的关键字。以打开浏览器为例，输入关键字“open”进行搜索，查询到一个“Open Browser”的关键字，点击这个关键字，就出现了它的用法和说明，如图7。

图7.Search Keywords

熟悉这个关键字用法之后，可以在test case 里面进行尝试。“Open Application”显示蓝色，说明它是一个合法的关键字，后面为红色说明需要输入一个参数，从其用法可知，需要输入URL。更多关键字的用法可以熟悉API 文件。

图8.keywords 实例

编写测试用例的时候还可以选择添加变量。变量是RF 的常用的功能，它能在测试数据的大多数地方使用。主要有以下几种：

标量变量：语法${scalar }。当在测试数据中使用标量变量时，它们将被分配的值所代替。列表变量：语法@{LIST}。列表变量是复合变量，可以分配多个值给它。

数字变量：变量语法可以用来创建一个全是整型和浮点型的数字：整型${80}、浮点型${3.14}。

Boolean 变量：${true/false}。

Null/None 变量：${null/None}。

空格${SPACE} 和空${EMPTY} 变量等。

图9. 添加变量

Demo：

Open Application Calculator：打开手机自带的计算器

Edit

Text Edit

Ps：第六行是一行，没有第七行

说明

“Open Application”：Keywords，方法,后面的全是参数。http://localhost:4723/wd/hub ，手机的url，这里一般固定不变platformName，平台名称，Android或者IOS

platformVersion，平台版本，也就是Android的版本号

deviceName，设备名称，就是运行中的模拟器的名称，如果不知道，可以通过在命令行中输入adb devices指令取得。

appPackage，app的包名，UiautomatorView可以获取

appActivity，app打开首页activity name，获取命令adb logcat ActivityManager:I *:s

运行测试用例

以上几步完成后，就可以在Run 页面，进行运行，并查看结果，具体如图10 所示：

在运行完测试之后，也可以进行查看log 文件等操作。

图10. 运行测试用例

简单的测试用例的编写

安装完成RF 之后，通过RIDE 编辑器的介绍，对RF 的工作原理有一定了解之后，在这一部分主要给大家介绍一个简单的实例：从服务器上下载指定的文件。

首先按照上面的步骤来进行：创建项目---->创建Test Suite---->创建Test Case。

创建项目

菜单File -> New Project，在弹出“New Project”对话框选择Type 为Directory，然后填写Name，点击OK 按钮。

创建Test Suite

在已创建的项目上点击鼠标右键，选择New Suite，在弹出“Add Suite”对话框中选择Type 为File，然后填写Name，点击OK 按钮。

添加所需的库文件，选定Suite 然后点击右边Library 按钮，在弹出对话框的Name 后输入FtpLibrary 并点击OK 按钮，添加其他Library 也是如此，具体如图11 所示：

图11. 添加Library

点击查看大图

添加所需的变量，选定Suite 然后点击右边Add Scalar 按钮，在弹出对话框的Name 后输入变量名，注意变量的结构是${name}or @{name}，在Value 后输入变量的值。

图12. 添加变量

点击查看大图

创建Test Case

在已创建的suite 点击鼠标右键选择New Test Case，在弹出对话框的Name 填写Name，点击OK 按钮。

至此，项目已经创建好了，Suite 创建了也添加了所需要的Library，Test Case 也创建好了，接下来就可以在Test Case 里编写测试用例了，也就是在表格输入关键字和参数或变量。

图13.TestCase 实例

点击查看大图

注：在图中表格里的蓝色字体是库中的关键字，绿色字体是变量，黑色字体是系统自带关键字。

下面对OnPremise 这个test case 进行解释。

图14.OnPremise--连接FTP 服务器

点击查看大图

目的：连接FTP 服务器。

通过关键字ftp connect 以及参数，包括用户名${uname_ftp_server} 和密码${pwd_ftp_sever}，来连接FTP 服务器${build_ftp_sever}，并设定超时时间为300 秒。图15.OnPremise--记录当前路径

目的：记录当前路径。

Cwd 关键字切换并进入所需路径${path_ftp_server}，然后通过Pwd 输出当前路径并保存到变量${output} 中。

图16.OnPremise--创建本地文件夹

点击查看大图

目的：创建本地文件夹，用来存放下载的文件。

由于服务器路径目录是以日期结束，将此通过Split String From Right 关键字分离出来并保存到${currentBuildLevel}，最后生成完整路径${currentDestination}，并通过Create

Directory 关键字来创建目标文件夹。

图17.OnPremise--下载所有所需的文件

点击查看大图

目的：下载所有所需的文件。

需要下载的文件不止一个，可通过FOR 循环在列表变量@{targetFiles} 中分别取出目标文件名，再通过Download File 关键字来逐一下载并保存到${currentDestination} 路径下。回页首

总结

Robot framework 关键字自动化框架，它拥有强大而丰富的Library，以及简单易用的关键字方式的使用，可以很好地支持全球化测试部门的测试工作，从而减少编写代码的时间同时也大大地提高了工作效率。相信通过对Robot framework 关键字自动化框架更深的使用和了解，将不仅仅只是帮助自动下载文件，也会在更多更广的方面带来越来越多的益处。

参考资料

RF官网

https://www.360docs.net/doc/8f8939249.html,/#test-libraries

github

https://https://www.360docs.net/doc/8f8939249.html,/robotframework/Selenium2Library https://https://www.360docs.net/doc/8f8939249.html,/piaoransk/robotframework-appiumlibrary