Robotium-api整理

assertCurrentActivity

public void assertCurrentActivity(String message,Class expectedClass)

检查当前程序显示的Activity是否是预期的Activity。

参数:

message – 如果断言失败，显示此消息

expectedClass – 预期的Activity类对象

例：assertCurrentActivity(“不是MyActivity”,MyActivity.class);

 

public voidassertCurrentActivity(String message,Class expectedClass,boolean isNewInstance)

检查当前程序显示的Activity是否是预期的Activity。并验证预期的Activity是否是一个新的Activity实例。

参数:

message -如果断言失败，显示此消息

expectedClass -预期的Activity类

isNewInstance – true如果预期的Activity是一个新的Activity实例。

 

public voidassertCurrentActivity(String message,String name)

检查当前程序显示的Activity是否是预期的Activity。

参数:

message – 如果断言失败，显示此消息

name – 预期的Activity类的名称

例：assertCurrentActivity(“不是MyActivity”,“MyActivity”);

 

public voidassertCurrentActivity(String message,String name, boolean isNewInstance)

检查当前程序显示的Activity是否是预期的Activity。并验证预期的Activity是否是一个新的Activity实例。

参数:

message -如果断言失败，显示此消息

expectedClass -预期的Activity类的名称

isNewInstance – true如果预期的Activity是一个新的Activity实例

assertMemoryNotLow

public void assertMemoryNotLow()

断言系统可用内存是否过低。

 clearEditText

publicvoid clearEditText(android.widget.EditText editText)

清空输入框的值。

参数:

editText – 要清空的输入框

 

publicvoid clearEditText(int index)

清空输入框的值。

参数:

index – 要清空的输入框位置. 如果只有一个输入框，则index为0。

 clickInList

publicArrayList<android.widget.TextView>clickInList(int line)

点击一个给定的列表行并返回此行显示的TextView集合，默认操作第一个ListView。

参数:

line – 被点击的行

返回:

返回包含TextView对象的集合

 

publicArrayList<android.widget.TextView>clickInList(int line,int index)

点击当前textlist中的第line行，可以指定listview的索引，不指定时默认为第一个

参数：

line-点击第几行

index-点击第几个listview，通过index标识

返回：

ArrayList-本行中被点击的TextView

clickLongInList

public ArrayList<android.widget.TextView> clickLongInList(int line)

长按一个给定的列表行并返回此行显示的TextView集合，默认操作第一个找到的ListView。

参数:

line – 被点击的行

Returns:

返回此行一个包含TextView对象的数组

ArrayList<android.widget.TextView> clickLongInList(int line,int index)

长按一个指定的ListView中给定的列表行并返回此行显示的TextView集合。

参数:

line – 被点击的行

index – 列表索引. 1 表示当前有两个列表

Returns:

返回位于指定列表中指定行的TextView对象数组

ArrayList<android.widget.TextView> clickLongInList(int line,int index, int time)

长按一个指定的ListView中给定的列表行并返回此行显示的TextView集合。

参数:

line – 被点击的行

index – 列表索引. 1 表示当前有两个列表

time – 长按的时间

Returns:

返回位于指定列表中指定行的TextView对象数组

 

clickLongOnScreen

voidclickLongOnScreen(float x,float y)

长按屏幕上给定的坐标

参数:

x – x的坐标

y – y的坐标

voidclickLongOnScreen(float x,float y,int time)

长按屏幕上给定的坐标一段时间

参数:

x – x的坐标

y – y的坐标

time – 长按时间

 

clickLongOnText

public voidclickLongOnText(String text)

长按一个给定的视图（控件）.当需要的时候自动滚动. 然后clickOnText(String) 可以在长按以后用来点击上下文显示的菜单项。 

参数:

text – 被点击的文本. 这个参数可以作为一个正则表达式

---

public voidclickLongOnText(String text,int match)

长按一个给定的视图（控件）.当需要的时候自动滚动. 然后clickOnText(String) 可以在长按以后用来点击上下文显示的菜单项。

参数:

text – 被点击的文本. 这个参数可以作为一个正则表达式

match – 如果多个对象（控件）匹配这个文本, 这将确定哪一个被点击

---

public voidclickLongOnText(String text,int match, boolean scroll)

长按一个给定的视图（控件）. 然后clickOnText(String) 可以在长按以后用来点击上下文显示的菜单项。

参数:

text – 被点击的文本. 这个参数可以作为一个正则表达式

match – 如果多个对象（控件）匹配这个文本, 这将确定哪一个被点击

scroll – 如果为真则表示在需要时滚动，否则只在当前屏幕内查找

---

public voidclickLongOnText(String text,int match, int time)

长按一个给定的视图（控件）. 然后clickOnText(String) 可以在长按以后用来点击上下文显示的菜单项。

参数:

text – 被点击的文本. 这个参数可以作为一个正则表达式

match – 如果多个对象（控件）匹配这个文本, 这将确定哪一个被点击

time – 长按的时间

 

public voidclickLongOnTextAndPress(String text,int index)

长按一个给定的视图（控件），然后从显示的上下文菜单中选择一个选项。当需要的时候自动滚动。 

参数:

text – 被点击的文本. 这个参数可以作为一个正则表达式

index – 被点击的菜单项索引. 如果为0表示仅仅一个可用

clickLongOnView

public void clickLongOnView(android.view.View view)

长按一个给定的视图（控件）. 

参数:

view – 被长按的视图

---

public voidclickLongOnView(android.view.View view, int time)

长按一个给定的视图（控件）. 

参数:

view – 被长按的视图

 time –长按的时间

 

clickOnActionBarHomeButton

public voidclickOnActionBarHomeButton()

点击ActionBar的home或者up按钮.

clickOnActionBarHomeButton()的作用就是点击ActionBar的此区域。

 

clickOnActionBarItem

public voidclickOnActionBarItem(int resourceId)

点击一个给定id的ActionBar选项。 

参数:

resourceId – ActionBar选项的选项对应的id(R.id)

 

clickOnButton

public void clickOnButton(int index)

通过一个给定的索引点击一个按钮。

参数:

index – 点击的按钮索引. 如果是0则表示只有一个可用

 

 

public void clickOnButton(String name)

通过一个给定的字符串点击一个按钮. 当需要的时候讲自动滚动. 

参数:

name – 呈现给用户的按钮名称. 参数可以作为一个正则表达式。

 

clickOnCheckBox

public void clickOnCheckBox(int index)

通过给定的索引点击一个复选框. 

参数:

index – 被点击的复选框索引. 如果是0则表示只有一个可用。

 

clickOnEditText

public void clickOnEditText(int index)

通过给定的索引点击一个文本框. 

参数:

index – 被点击的文本框索引. 如果是0则表示只有一个可用。

 

clickOnImage

public void clickOnImage(int index)

通过指定的索引点击一个ImageView. 

 

参数:

index – 被点击的ImageView索引. 0表示仅仅一个可用

 

clickOnImageButton

public void clickOnImageButton(int index)

点击一个匹配的ImageButton索引

参数:

index – 被点击的ImageButton索引.0表示仅仅一个可用

 

public String getWebUrl()

返回当前页面的URL.

返回:

当前页面的URLL

注意：此方法默认返回index为0的WebView的URL。

 

getButton

publicandroid.widget.ButtongetButton(int index)

 

返回指定索引值的Button控件

参数:

index –索引值，如果只有一个button，则index为0

publicandroid.widget.ButtongetButton(String text)

返回指定文本的Button控件

参数:

text –显示的文本，可指定一个正则表达式

返回:

显示指定文本的按钮

publicandroid.widget.ButtongetButton( String  text, boolean onlyVisible)

返回指定文本的Button控件

参数:

text –显示的文本，可指定一个正则表达式

onlyVisible——如果按钮在屏幕上可见，则为真

返回:

显示指定文本的按钮

 

 

publicArrayList<android.view.View>getCurrentViews()

返回当前activity或对话框的所有view的集合

返回:

当前窗口的View对象的集合

public<Textends android.view.View>ArrayList<T>getCurrentViews(Class<T> classToFilterBy)

返回当前activity或对话框的所有view的集合，可匹配指定的类

参数:

classToFilterBy–返回该类的所有实例。例如：Button.class或ListView.class

返回:

当前Activity中，匹配指定类的View的集合

 

public<Textends android.view.View>ArrayList<T>getCurrentViews(Class<T> classToFilterBy,android.view.View parent)

返回当前activity或对话框的所有view的集合，可匹配指定的类，并指定父类

参数:

classToFilterBy–返回该类的所有实例。例如：Button.class或ListView.class

parent——父节点，从该节点开始遍历

返回:

当前Activity中，匹配指定类，指定父类的View的集合

 

publicandroid.widget.EditTextgetEditText(int index)

返回指定索引值的editText控件

参数:

index –索引值，如果只有一个editText，则index为0

publicandroid.widget.EditTextgetEditText(String text)

返回指定文本的editText控件

参数:

text –显示的文本，可指定一个正则表达式

返回:

显示指定文本的editText控件

publicandroid.widget.EditTextgetEditText(String text,boolean onlyVisible)

返回指定文本的editText控件

参数:

text –显示的文本，可指定一个正则表达式

onlyVisible——如果按钮在屏幕上可见，则为真

返回:

显示指定文本的editText控件

 

 

public<Textends android.view.View> T getView(Class<T> viewClass, int index)

返回指定view类和索引的view控件

参数:

viewClass–要指定的view类

index–索引，如果只有一个，则index为0

返回:

符合条件的view控件

 

publicandroid.view.ViewgetView(int id)

返回指定ID的view控件

参数:

id–view控件的R.id，int 类型

返回:

符合条件的view控件

 

publicandroid.view.ViewgetView(int id,int index)

返回指定ID和索引的view控件

参数:

id–view控件的R.id，int 类型

index –索引，如果只有一个，则index为0

返回:

符合条件的view控件

 

publicandroid.view.ViewgetView(String id)

返回指定ID的view控件

参数:

id–view控件的id，String 类型

返回:

符合条件的view控件

 

publicandroid.view.ViewgetView(String id,int index)

返回指定ID和索引的view控件

参数:

id–view控件的id，String 类型

index –索引，如果只有一个，则index为0

返回:

符合条件的view控件

 

publicArrayList<android.view.View>getViews()

返回当前Activity或对话框的所有view控件的集合

参数:

viewClass–要指定的view类

index –索引，如果只有一个，则index为0

返回:

当前窗口的所有view对象的集合

publicArrayList<android.view.View>getViews(android.view.View parent)

返回某父类下所有view对象的集合

参数:

parent –父类view，从该view开始遍历，返回所有的view对象

返回:

包含在指定view下的所有view对象的集合

 

 

publicvoid goBack()

相当于手机上的返回键

 

publicvoid goBackToActivity(String name)

返回到指定名字的Activity

参数:

name – 要返回到的Activity的名字. 例如: "MyActivity"

 

 

booleanisCheckBoxChecked (int index | String text)

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

参数：

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

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

返回：

true-如果被选中

false-如果没有被选中

 

 

publicbooleanisRadioButtonChecked(int index | String text)

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

参数：

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

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

返回：

true-如果被选中

false-如果没有被选中

 

 

publicbooleanisTextChecked(String text)

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

参数：

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

返回：

true-如果被选中

false-如果没有被选中

 

 

booleansearchButton(String text [, intminimumNumberOfMatches, booleanonlyVisible])

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

参数：

text-查找的button的文字

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

onlyVisible-只记录可见的

返回：

true-如果找到了该控件

false-如果没有找到该控件

 

 

booleansearchText(String text [, intminimumNumberOfMatches, boolean scroll, BooleanonlyVisible])

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

参数：

text-查找的Text的文字

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

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

onlyVisible-只记录可见的

返回：

true-如果找到了该文本

false-如果没有找到该文本

 

 

booleansearchEditText(String text)

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

参数：

text-查找的Text的文字

返回：

true-如果找到了该文本

false-如果没有找到该文本

 

typeTextInWebElement

该方法根据传入参数不同有不同使用方法。

publicvoid typeTextInWebElement(By by, String text)

参数:

by – By对象，如: By.id("id") 和 By.name("name")

text – 待输入的文本内容。

Match – 假定有多个对象，根据此值决定匹配哪一个。

例子：

publicvoid testSearch(){

    solo.sleep(4000);

    webview = (WebView)solo.getView(R.id.webView1); //word是百度网页搜索框的name值，补充手机访问的是//wap.baidu.com 查询id或name可以通过firefox很方便的得到 By search =By.name("word"); solo.typeTextInWebElement(search, "robotium中文网");

 

enterText

publicvoid enterText(int index, String text)

在一个给定位置的EditText中输入文本。

参数：

index– EditText的位置。如果只有一个可用的则为0。 text – 输入到EditText中的文本字符串。

 

publicvoid enterText(android.widget.EditTexteditText, String text)    

在一个给定的EditText输入文本。

参数：

editText– 待输入的editText。 text - 输入到EditText中的文本字符串。

 

publicvoid typeText(int index, String text)

       在一个给定位置的EditText输入文本。

参数：

       index – EditText的位置。如果只有一个可用的则为0。

       text – 输入到EditText中的文本字符串。

 

publicvoid typeText(android.widget.EditText editText, String text)

       在一个给定的EditText输入文本。

参数：

       editText – 待输入的editText。

       text - 输入到EditText中的文本字符串。

 

waitForActivity

publicbooleanwaitForActivity(java.lang.Stringname)

等待一个匹配指定名称的Activity，默认超时时间30秒。
参数：
name – 指定的Activity名字，如“MyActivity“。
返回：
true 假如指定的Activity在超时前出现；反之则，false。

publicbooleanwaitForActivity(java.lang.Stringname,inttimeout)

参数：
timeout – 等待的时间（毫秒计算）。

publicbooleanwaitForActivity(java.lang.Class<?extends android.app.Activity>activityClass)

参数：
activityClass – 指定的Activity，如“MyActivity.class”。

该方法使用Waiter类中的waitForActivity方法来实现，通过getCurrentActivity方法得到当前Activity，来和指定的Activity进行对比。

 

waitForDialogToClose

publicboolean waitForDialogToClose(long timeout)

等待一个对话框关闭

参数:

timeout – 等待的超时时间。

返回:

如果对话框在超时时间之前关闭就返回true,反之则false。

 

waitForDialogToOpen

publicbooleanwaitForDialogToOpen(long timeout)

等待一个对话框打开

参数:

timeout – 等待的超时时间。

返回:

如果对话框在超时时间之前打开就返回true,反之则false。

 

waitForFragmentById

publicboolean waitForFragmentById(int id)

 等待一个匹配id的fragment,默认超时时间20秒。

参数:

id – 给定的匹配的id。

返回:

如果fragment在超时时间之前出现就返回true,反之则false。

 

publicboolean waitForFragmentByTag(java.lang.String tag)

等待一个匹配标签的fragment,默认超时时间20秒。

参数:

tag –标签的名称。

返回:

如果fragment在超时时间出现打开就返回true,反之则false。

 

publicboolean waitForLogMessage(java.lang.String logMessage)

等待指定的日志消息出现。需要读日志权限（android.permission.READ_LOGS），在应用程序的AndroidManifest.xml文件中配置。

参数:

logMessage –等待的日志信息内容。

返回:

如果日志在超时时间之前找到就返回true,反之则false。

 

waitForText

publicboolean waitForText(java.lang.String text)

等待指定的文本出现。默认的超时时间是20秒。

参数:

text –等待的出现的文本内容，。

返回:

如果文本在超时时间之前找到就返回true,反之则false。

 

public<T extendsandroid.view.View>booleanwaitForView(java.lang.Class<T> viewClass)

等待一个指定的匹配类型的View出现，默认超时时间20秒。

参数:

text – 等待出现View对象

返回:

如果View在超时时间之前找到就返回true,反之则false。

 

publicbooleanwaitForWebElement(By by)

等待一个指定的匹配的By对象的WebElement出现，默认超时时间20秒。

参数:

by – by对象，例如： By.id(“id”) 和 By.name(“name”)

返回:

如果WebElement在超时时间之前出现就返回true,反之则false。