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。