Robot Framework +Appium的简单教程及实例

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://www.python.org/downloads/。

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

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

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

安装adb

1.下载android sdk

2.新建环境变量ANDROID_HOME,值为sdk路径

ANDROID_HOME

E:\Tool\devtool\eclipse\adt-bundle-windows-x86_64-20140702\sdk\

3.将sdk目录下的platform-tools设置到系统变量的path中

%ANDROID_HOME%

4.验证adb是否安装好

打开cmd 命令行输入adb 是否有一大串adb help的提示信息

安装 WxPython

下载页面： http://wxpython.org/download.php#stable。

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

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

https://sourceforge.net/projects/wxpython/files/wxPython/2.8.12.1/

安装 PyCrypto

下载页面：http://www.voidspace.org.uk/python/modules.shtml#pycrypto。

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

安装 Robot Framwork

进入 Python 的安装路径，执行命令“pip install robotframework”或者通过下载页面https://pypi.python.org/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,archivelibrary,SSHLibrary ,ftplibrary 等。

进入 Python 的安装路径，分别执行以下命令：

pip install robotframework-appiumlibrary

pip install robotframework-selenium2library

pip install robotframework-archivelibrary

pip install robotframework-SSHLibrary

ip install robotframework-ftplibrary

ps:如果pip install不行就用easy_install

安装和配置appium

官网下载appium的windows安装包

官网：https://bitbucket.org/appium/appium.app/downloads/

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

图 0.Appium配置图



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

图 1.RobotFramework 安装产品列表

RIDE 编辑器介绍

官方文档

http://robotframework.org/robotframework/#user-guide

打开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

adb logcat 查看日志:http://blog.csdn.net/xyz_lmn/article/details/7004710

如下图是华为setting的activity



logcat 详细使用说明：http://blog.csdn.net/xyz_lmn/article/details/7004710

运行测试用例

以上几步完成后，就可以在 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 以及参数，包括用户名unameftpserver和密码{pwd_ftp_sever}，来连接
FTP 服务器${build_ftp_sever}，并设定超时时间为 300 秒。

图 15.OnPremise–记录当前路径



目的：记录当前路径。

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

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



点击查看大图

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

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

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



点击查看大图

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

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

回页首

总结

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

知识点：

Robotframework 的基本使用，掌握buildin的方法

Log，Run keyword if以及数据类型等等
Uiautomatorview获取app元素
Appium 元素的定位和click,swipe点击操作。

参考资料

Robotframework官网

Robotframework-首页

Robotframework-user guide

github地址

Selenium2Library

robotframework-appiumlibrary

FAQ

1. Pip安装失败，连接不上服务器

使用镜像的方法可以在每次执行pip的时候加上参数”-i http://e.pypi.python.org/simple“即可，

或者也可以在本地配置，这样就不用每次都加上参数了，应用Cheer Xiao的配置（http://blog.makto.me/post/2012-11-01/pypi-mirror）：

[global]

index-url=http://mirrors.tuna.tsinghua.edu.cn/pypi/simple

2. 问题异常: ‘ascii’ codec can’t encode characters

“C:\Python27\lib\site-packages\pip-8.1.2-py2.7.egg\pip_vendor\colorama\ansitowin32.py”, line 174, in write_plain_text

self.wrapped.write(text[start:end])

UnicodeEncodeError: ‘ascii’ codec can’t encode character u’\u258a’ in position 8: ordinal not in range(128)

解决办法：

字符集的问题，在文件前加两句话：

reload(sys)

sys.setdefaultencoding( “utf-8” )

完美解决，ok

ps 当字符串里有 \n、\t、\r时，json.loads()失效，异常，要去掉

3. pip的安装

先安装setuptools

4. 出现Unable to find vcvarsall.bat问题

安装vs2008或者更新新版本都可以

http://stackoverflow.com/questions/2817869/error-unable-to-find-vcvarsall-bat

http://blog.csdn.net/secretx/article/details/17472107

5. 如何开发系统关键字

http://note.youdao.com/noteshare?id=32cb67775f6ee73642c4ff768b581853

6. 如何定位元素

http://note.youdao.com/noteshare?id=3842ebf1411a12f1fc49e2e2e5bc49c9

7. 多个元素如何定位

利用xpath

8. 用pybot命令有3种执行RF用例的方式：
http://note.youdao.com/noteshare?id=b1d1f4b6c1739c74fff7da24b16bfda7
9.更多分享

http://note.youdao.com/noteshare?id=d33942274ccaaa9cb4e07440c9fd0136