Robotium Solo Api 简介

------手机自动化测试之Robotium

 Robotium是一个通用的测试Android App的框架，所以官方提供了一套通用的PKI文档。我们在下载Solo包的时候同时可以下载一个javadoc包，解压后就能看到官方文档了，不过官方文档是英文版本的，如果通读一遍的话也是挺有难度的。还好网上也有对应的翻译，所以我们不打算讲述所有的API，只讲解一些儿常用的。

3.1 点击类操作

在手机App操作中，点击操作是非常常用的，下面几个API是基本的点击操作：

（1）clickOnText(String text)

clickOnText(java.lang.String text, int match)  clickOnText(java.lang.String text, int match, boolean scroll) 

功能：点击包含该文字的地方，其中text可以用正则表达式表示。如：(?i)----忽略大小写。默认情况是大小写敏感的，正则表达式与java保持一致。Scroll：true如果可滚动Match：匹配

（2）clickLongOnText(String text)

clickLongOnText(java.lang.String text, int match) clickLongOnText(java.lang.String text, int match, boolean scroll) clickLongOnText(java.lang.String text, int match, int time) 

功能：长按一个包含该文字的地方。

参数：

Scroll：true如果可滚动 ，Time：长按的时间 Match：匹配

（3） clickOnButton(int index) 

clickOnButton(java.lang.String name) 

功能：以序号或是名称单击各种按钮，index代表这个按钮在view中的序号，name是属性值。

（4）clickOnImageButton(int index)  

功能：以序号的方式单击一个图片按钮。

（5）clickOnCheckBox(int index)

功能：以序号的方式单击一个复选按钮。

（6）clickOnRadioButton(int index) 

功能：以序号来单击一个单选按钮。

（7）clickOnToggleButton(java.lang.String name)

功能：点击一个切换按钮

（8） clickOnEditText(int index)

功能：以序号来单击文本框，使其获得焦点，然后执行后序的操作。

（9）clickOnScreen(float x, float y)

clickLongOnScreen(float x, float y)

    clickLongOnScreen(float x, float y, int time) 

功能：单击屏幕的某一坐标。参数x,y标识出坐标的位置，time 代表长按的时间。

（10）clickLongOnTextAndPress(java.lang.String text, int index) 

功能：长按后从list中选择一个项目 

（11）clickOnView(android.view.View view) clickLongOnView(android.view.View view) clickLongOnView(android.view.View view, int time) 

功能：单击一个View，或是长按一个View，参数time代码长按的时间。

（12）clickOnImage(int index)  

功能：以序号来执行单击图片操作。

（13）clickOnMenuItem(java.lang.String text) clickOnMenuItem(java.lang.String text, boolean subMenu) 

功能：以菜单项来单击选择菜单，参数subMenu：子菜单，如果可以设置在子菜单中 

3.2 输入类操作

  对要操作的App进行输入操作，这也是常见的操作，Robotium输入操作有如下几种：

（1）void enterText(android.widget.EditText editText, String text)

  功能：向一个符合条件的EditText输入特定的文本。

（2）void enterText(int index, String text)

  功能：对特定的符合序号index的文本框输入文本。

（3）void enterTextInWebElement(By by, String text)

   功能：通过By定位，对页面元素输入文本。

（4）void clearEditText(android.widget.EditText editText)

  功能：清除特定的文本框中的内容。

（5）void clearEditText(int index)

  功能：清除符合序号index的文本框中的内容。

（6）void clearLog()

  功能：清除日志文件

（7）void clearTextInWebElement(By by)

  功能：清除页面元素文本框内的信息。

这些儿是常用的输入操作，为了不影响操作效果，建议在对文本框进行输入之前，先清空一下。当然像菜单选择，单选框，多选框也能输入的，这些儿操作在上一节已经讲过。

3.3 Get相关操作

在对App元素进行操作之前，首先要获取这个元素的句柄，然后再去执行相关的操作。所以获取到要操作的元素是第一步的，这也是自动化操作最基本的。

（1）getButton(int index) 

getButton(java.lang.String text) 

getButton(java.lang.String text, boolean onlyVisible) 

功能：通过序号，文本获取按钮，参数onlyVisible为true时只获取可见的按钮。

（2）getCurrentActivity() 

功能：返回当前activity。

（3）getCurrentButtons() 

功能：返回button的list。

(4)getCurrentCheckBoxes() 

功能:返回复选框的list。

（5）getCurrentDatePickers() 

功能：返回日期选择器的list。

（6） getCurrentEditTexts() 

功能：返回当前文本框的list

（7）getCurrentGridViews()  

功能：获取当前网格视图List。

（8） getCurrentImageButtons()

getImageButton(int index)

功能：获取当前图片按钮list；根据序号获取图片按钮。

（9）getCurrentImageViews() 

功能：获取当前ImageView列表。

（10）getCurrentListViews()

功能：获取当前ListView列表。

（11）getCurrentProgressBars() 

功能：获取当前进度条信息。

（12）getCurrentRadioButtons() 

功能：获取当前单选按钮列表。

（13）getCurrentScrollViews() 

功能：获取当前滚动条列表。

（14）getCurrentTextViews(android.view.View parent) 

功能：获取当前TextView的列表。

（15）getCurrentViews()

getView(int id)  getViews() 

getViews(android.view.View parent)  

功能：获取当前View,或是所有View的列表。 

（16）getEditText(int index) 

getEditText(java.lang.String text) 

getEditText(java.lang.String text, boolean onlyVisible)  

功能：根据序号，文本获取EditText的句柄。

（17）getText(int index) 

getText(java.lang.String text) 

getText(java.lang.String text, boolean onlyVisible) 

功能：获取文本

3.4 Search相关操作

   在要操作的App中查找到相关的元素或是文本，这个是判读执行结果的时候很重要的一步作，下面我们将常用的查找元素的方法介绍一下：

（1）boolean searchButton (String text [, int minimumNumberOfMatches, boolean onlyVisible])

功能：判断当前的屏幕中是否能找到指定的button

参数：

text-查找的button的文字

minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个

onlyVisible-只记录可见的

返回：

true-如果找到了该控件

false-如果没有找到该控件

（2）boolean searchText (String text [, int minimumNumberOfMatches, boolean scroll, boolean onlyVisible])

功能：判断当前的屏幕中是否能找到指定的text，即文本。

参数：

text-查找的Text的文字

minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个

scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找

onlyVisible-只记录可见的

返回：

true-如果找到了该文本

false-如果没有找到该文本

（3）boolean searchToggleButton (String text [, int minimumNumberOfMatches])

功能：判断当前的屏幕中是否能找到指定的ToggleButton

参数：text-查找的ToggleButton的文字。

minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个。

返回：

true-如果找到了该控件

false-如果没有找到该控件

（4）boolean searchEditText (String text)

判断当前的屏幕中是否能找到指定的EditText

参数：text-查找的Text的文字

返回：

true-如果找到了该文本

false-如果没有找到该文本

3.5 Assert断言相关操作

   断言是自动化测试的关键，任何测试操作都是由断言来检测用例执行的是否正确。好的断言设置是体现自动化测试人员水平的关键，我们还是先了解一下robotium的断言函数吧！

（1）void assertCurrentActivity (String message, Class activityClass [,boolean isNewInstance])

功能：断言当前的activity是否是预期的

参数：message-如果运行失败打印的消息。

activityClass-预期的activity。

isNewInstance-可选项，实际activity是否是预期activity的继承，如果为true则只要是继承关系就通过，false则必须是当前activity

返回：无

（2）void assertCurrentActivity (String message, String name [,boolean isNewInstance])

功能：断言当前的activity是否是预期的

参数：

message-如果运行失败打印的消息

name-预期activity的名字

isNewInstance-可选项，实际activity是否是预期activity的继承，如果为true则只要是继承关系就通过，false则必须是当前activity

返回：无

（3）void assertMemoryNotLow()

功能：断言目前系统可用内存是否过低，内存空间足够则通过

返回：无

is方法，虽然不是断言，但可以当断言来用。

（4）boolean isCheckBoxChecked (int index | String text)

功能：判断checkBox是否处于被选中的状态，可以通过index和text两种方法定位

参数：

index-检查的checkBox的索引值，如果只有一个可用则为0

text-检查的checkBox的文字，可使用正则表达式

返回：

true-如果被选中

false-如果没有被选中

（5）boolean isRadioButtonChecked (int index | String text)

功能：判断RadioButton是否处于被选中的状态，可以通过index和text两种方法定位

参数：

index-检查的RadioButton的索引值，如果只有一个可用则为0

text-检查的RadioButton的文字，可使用正则表达式

返回：

true-如果被选中

false-如果没有被选中

（6）boolean isRadioButtonChecked (int index | String text)

功能：判断RadioButton是否处于被选中的状态，可以通过index和text两种方法定位

参数：

index-检查的RadioButton的索引值，如果只有一个可用则为0

text-检查的RadioButton的文字，可使用正则表达式

返回：

true-如果被选中

false-如果没有被选中

（7）boolean isToggleButtonChecked (int index | String text)

功能：判断ToggleButton是否处于被选中的状态，可以通过index和text两种方法定位。

参数：

index-检查的ToggleButton的索引值，如果只有一个可用则为0。

text-检查的ToggleButton的文字，可使用正则表达式。

返回：

true-如果被选中

false-如果没有被选中

（8）boolean isTextChecked (String text)

功能：判断text是否处于被选中的状态，可以通过text定位

参数：text-检查的text的文字，可使用正则表达式

返回：

true-如果被选中

false-如果没有被选中

3.6 本章小结

  本章我们介绍了Robotium API,solo相关函数，这些儿只是基本的，常用的，但是还有很多相关的函数，随着版本的更新，会增加新的方法。所以建议大家去官方下载最新的API文档，随时了解最新的函数情况，以便更好的编写自己的自动化测试代码。本章我们先了解有哪些儿方法，其功能是什么，参数有哪些儿，致于如何使用，下面的章节我们将会慢慢地介绍到。