robotium API中文翻译

1、Robotium API 翻译（一）click/clickLong操作 .click&clickLong方法（点击/长按事件） ArrayList clickList(int line,int index) 点击当前textlist中的第line行，可以指定listview的索引，不指定时默认为第一个 参数： line-点击第几行 index-点击第几个listview，通过index标识 返回： ArrayList-本行中被点击的TextView ArrayList clickLongList(int line,int index,int time) 长按当前textlist中的第line行

2、，可以指定listview的索引，不指定时默认为第一个 参数： line-点击第几行 index-点击第几个listview，通过index标识 time-长按的时间 返回： ArrayList-本行中被点击的TextView void clickOnScreen(float x,float y, int numberOfClicks) 按照坐标点击屏幕 参数： x-点击位置的x坐标 y-点击位置的y坐标 numberOfClicks-点击几次 返回： 无 void clickLongOnScreen(float x,float y, int time) 按照坐标长按屏幕 参数： x-长按位置

3、的x坐标 y-长按位置的y坐标 time-长按的时间 返回： 无 void clickOnText(String text , int match, boolean scroll) 点击屏幕内的某个文本 参数： text-点击的字符 match-如果有多个匹配的话，点击的第几个 scroll-如果是true的话，会执行滚动屏幕的动作 返回： 无 void clickLongOnText(String text , int match, boolean scroll|int time) 长按屏幕内的某个文本 参数： text-长按的字符 match-如果有多个匹配的话，长按的第几个 scroll

4、-如果是true的话，会执行滚动屏幕的动作 time-长按的时间 返回： 无 void clickOnView (android.view.View.view ,boolean immediately) 点击一个view，可设置忽略等待 参数： view-view名称 immediately-如果为true的话，忽略任何等待立即点击 返回： 无 void clickLongOnView (android.view.View.view ,int time) 长按一个view 参数： view-view名称 time-长按的时间 返回： 无 void clickOnButton (int inde

5、x| String text) 点击一个按钮 参数： index-按钮的索引 text-按钮的文字 返回： 无 void clickOnImage (int index) 点击一个图片 参数： index-图片的索引 返回： 无 void clickOnImageButton (int index) 点击一个带图片的按钮 参数： index-按钮的索引 返回： 无 void clickOnEditText (int index) 点击一个可编辑的文本控件 参数： index-可编辑文本的索引 返回： 无 void clickOnCheckBox (int index) 点击一个复选框 参数：

6、index-复选框的索引 返回： 无 void clickOnToggleButton (String text) 点击一个开关按钮，并改变其状态 参数： text-开关按钮的文本 返回： 无 void clickOnMenuItem (String text , boolean subMenu) 点击MenuItem，即当点击系统menu键弹出的那个菜单 参数： text-menuItem的文本 subMenu-如果为true的时候，可以选择MenuItem的下级菜单 返回： 无 void clickOnRadioButton (int index) 点击一个进度按钮 参数： index-进

7、度按钮的索引 返回： 无 void clickOnActionBarHomeButton () 点击AcionBar的Home或者Up按钮，就是最上面那条的Home或者Up 参数： 无 返回： 无 void clickOnActionBarItem (int id) 点击ActionBar的选项 参数： 每个选项的id 返回： 无 void clickLongOnTextAndPress (String text, int index) 长按一个控件，并点击其中一个选项 参数： text-控件的文本 index-点击的索引 返回： 无 void clickOnWebElement (By by

8、 , int match , boolean scroll) 通过By属性识别，点击一个Web控件 参数： by-通过By的哪个属性来识别控件 match-如果多个web都匹配，选择第几个 scroll-如果为true的话，将执行滚动操作 返回： 无 void clickOnWebElement (WebElement webElement) 通过Web控件名称识别，点击一个Web控件 参数： webElement-web控件的名称 返回： 无Robotium API 翻译（二）除click/clickLong外的其他操作分类：Android自动化2014-07-04 14:4584人阅读评论

9、(0)收藏举报拖动操作void drag (float fromX, float toX, float fromY, float toY, int stepCount)选定两个位置，进行拖动操作（这里的拖动操作只会记录你的起点和终点，而不会理会你的运动路径）参数：fromX-起始位置的X坐标toX-终点的X坐标fromY-起始位置的Y坐标toY-终点的Y坐标stepCount-分几步完成返回：无void goBack()相当于按下系统返回键参数：无返回：无void hideSoftKeyboard()隐藏键盘，在软键盘弹出来的时候使用参数：无返回：无void sendKey(int key)向

10、应用发送键盘的key值，用于模拟键盘操作。注：不要向非测试界面发送sendKey，会报错参数：key-键盘的Key值，如UP，DOWN，ENTER，MENU等返回：无void sleep(int time)让测试停止若干时间以便进行下一步操作参数：time-停止的时间，单位是毫秒，如sleep(2000)，是停止了2秒钟返回：无void pressMenuItem (int index , int itemPerRow)通过菜单的索引按下菜单中制定的item参数：index-该item的索引值itemPerRow-每行有多少个item返回：无void pressSpinnerItem (int

11、 spinnerIndex, int itemIndex)点击下拉式菜单栏的item参数：spinnerIndex-下拉式菜单栏的索引值itemIndex-要点击的item的索引值，负数表示需要向上滚动才能找到的item，正数表示向下滚动可以找到的item返回：无滚动操作boolean scrollDown ()滚动条进行向下操作参数：无返回：true-如果可以进行滚动的话false-如果已经滚动到底部，无法滚动boolean scrollUp ()滚动条进行向上操作参数：无返回：true-如果可以进行滚动的话false-如果已经滚动到顶部，无法滚动boolean scrollUpList (

12、android.widget.AbsListView list | int index)操作一个list向上滚动参数：list-被操作的滚动条名称index-被操作的滚动条索引，如果是0，表示只有一个可以滚动的list返回：true-如果可以进行滚动的话false-如果已经滚动到顶部，无法滚动boolean scrollListToBottom (android.widget.AbsListView list | int index)操作一个list向下滚动一直滚动到底部参数：list-被操作的滚动条名称index-被操作的滚动条索引，如果是0，表示只有一个可以滚动的list返回：true-如

13、果可以进行滚动的话false-如果已经滚动到底部，无法滚动boolean scrollListToTop (android.widget.AbsListView list | int index)操作一个list向上滚动一直滚动到顶部参数：list-被操作的滚动条名称index-被操作的滚动条索引，如果是0，表示只有一个可以滚动的list返回：true-如果可以进行滚动的话false-如果已经滚动到顶部，无法滚动void scrollToBottom ()向下滚动屏幕，一直滚动到底部参数：无返回：无void scrollToTop ()向上滚动屏幕，一直滚动到顶部参数：无返回：无void sc

14、rollListToLine (android.widget.AbsListView list | int index , int line)操作滚动条滚动到list的某一行参数：参数：list-被操作的滚动条名称index-被操作的滚动条索引line-滚动到第几行返回：无水平滚动void scrollToSide (int side , float scrollPosition)水平滚动屏幕，可限制操作滚动的位置参数：side-水平滚动的方向，LEFT或者RIGHTscrollPosition-滚动屏幕的比例，从0到1，如果是0.5，则只会对一半的屏幕进行滚动返回：无scrollViewTo

15、Side (android.view.View.view view, int side , float scrollPosition)水平滚动某一个view，可限制操作滚动的位置参数：view-滚动的view名称side-水平滚动的方向，LEFT或者RIGHTscrollPosition-滚动屏幕的比例，从0到1，如果是0.5，则只会对一半的屏幕进行滚动返回：无其余特定控件操作屏幕方向void setActivityOrientation (int orientation)设置屏幕方向，即横屏还是竖屏参数：orientation-设置方向，LANDSCAPE表示横屏，PORTRAIT表示竖屏返

16、回：无datePicker控件void setDatePicker (android.widget.datePicker datePicker | int index, int year, int monthOfYear, int dayOfMonth)给datePicker控件设置日期参数：datePicker-操作的datePicker的名称index-操作的datePicker的索引值year-设置年的值，如2013monthOfYear-设置月份的值dayOfMonth-设置日的值返回：无timePicker控件void setTimePicker (android.widget.ti

17、mePicker timePicker | int index, int hour, int minute)给timePicker控件设置时间参数：timePicker-操作的timePicker的名称index-操作的timePicker的索引值hour-设置小时的值minute-设置分钟的值返回：无progressBar控件void setProgressBar (android.widget.ProgressBarprogressBar | int index, int progress)设置进度条的进度参数：progressBar-操作的进度条控件的名称index-操作的进度条控件的索

18、引值progress-设置进度条的进度返回：无slidingDrawer控件void setSlidingDrawer (android.widget.SlidingDrawer slidingDrawer| int index, int status)设置SlidingDrawer控件的开和关参数：slidingDrawer-操作的SlidingDrawer控件名称index-操作的SlidingDrawer控件的索引值status-设置的开关状态，solo.OPEN表示开，solo.CLOSE表示关返回：无输入方法enter和typevoid enterText (android.widg

19、et.EditText editText | int index, String text)对指定的editText输入文本参数：editText-指定的editText控件名称index-指定的editText索引值text-输入的文本返回：无void enterTextInWebElement (By by, String text)对指定的webEditText输入文本参数：by-识别webElement的属性text-输入的文本返回：无void typeText (android.widget.EditText editText | int index, String text)对指定

20、的editText输入文本参数：editText-指定的editText控件名称index-指定的editText索引值text-输入的文本返回：无void typeTextInWebElement (By by, String text)对指定的webEditText输入文本参数：by-识别webElement的属性text-输入的文本返回：无void typeTextInWebElement (WebElement webElement, String text)对指定的webEditText输入文本参数：webElement-指定的webElement控件名称text-输入的文本返回：无

21、clear方法（清除控件输入值）void clearText(int index)通过定位索引清除当前edittext的值参数：index 当前edittext的索引值返回：无void clearText(android.widget.EditText EditText)通过定位android控件清除当前edittext的值 参数：android.widget.EditText当前edittext的名称返回：无void clearTextInWebElement(By by)通过定位By的一些属性清除web控件的text文本参数：By-By方法中的属性，有id,name,tagName,tex

22、tContent,className,xpath,cssSelector等返回：无ClearLog()清除日志，不多解释返回：无双指操作void pinchToZoom (android.graphics.pointF startPoint1, android.graphics.pointF startPoint2, android.graphics.pointF endPoint1, android.graphics.pointF endPoint2)用两支手指进行夹紧和扩张的操作参数：startPoint1-第一只手指的起始位置startPoint2-第二只手指的起始位置endPoint1

23、-第一只手指的终止位置endPoint2-第二只手指的终止位置返回：无void swipe (android.graphics.pointF startPoint1, android.graphics.pointF startPoint2, android.graphics.pointF endPoint1, android.graphics.pointF endPoint2)用两支手指进行同时移动的操作参数：startPoint1-第一只手指的起始位置startPoint2-第二只手指的起始位置endPoint1-第一只手指的终止位置endPoint2-第二只手指的终止位置返回：无void

24、rotateLarge (android.graphics.pointF center1, android.graphics.pointF center2)大幅度进行两只手指画半圆？ 不确定，这个方法没用过参数：center1-第一个半圆的圆心，取值为0, Picenter2-第二个半圆的圆心，取值为Pi, 3*Pi返回：无void rotateSmall (android.graphics.pointF center1, android.graphics.pointF center2)小幅度进行两只手指画半圆？ 不确定这个方法，没用过参数：center1-第一个半圆的圆心，取值为0, Pic

25、enter2-第二个半圆的圆心，取值为Pi, 3*Pi返回：无操作activityvoid goBackToActivity(String name)返回到指定的activity参数：name-返回到的activity返回：无void finalize()终止当前的solo对象并删除activity的监控器参数：无返回：无void finishOpenedActivity()终止所有打开的activity对象，一般用在teardown()方法中参数：无返回：无截图操作void takeScreenshot (String name, int quality)对当前屏幕进行截屏操作，结果存放在/

26、sdcard/Robotium-Screenshots/路径下注：需要在AndroidManifest.xml中设置写权限，即android.permission.WRITE_EXTERNAL_STORAGE参数：可以不使用任何参数name-截图的名称quality-截图的质量，其实是压缩比例。取值从0到100，值越大，质量越高，默认80返回：无void startScreenshotSequence (String name , int quelity, int frameDelay, int maxFrames )开始一系列的连续截图操作，结果存放在/sdcard/Robotium-Scr

27、eenshots/路径下，命名方式为name_加序列号，从0开始。不支持多个模拟器同时截屏。注：需要在AndroidManifest.xml中设置写权限，即android.permission.WRITE_EXTERNAL_STORAGE参数：name-截图的前缀quality-截图的质量，其实是压缩比例。取值从0到100，值越大，质量越高，默认80frameDelay-两次截图的时间间隔，单位毫秒，建议不小于100，默认400maxFrames-最多截多少张，默认100返回：无void stopScreenshotSequence()结束连续截图操作参数：无返回：无Robotium API

28、翻译（三）判断测试结果的方法assert、is、search .分类：Android自动化2014-07-04 14:4358人阅读评论(0)收藏举报下面的这些方法都主要用来判断测试结果是否与预期结果相符，一般把is和search方法放在assert里面判断。assert最常用的还是assertThat方法，是Junit的判断，这里就不多说了。断言方法assert（robotium特有的断言方式，实际项目中和Junit的assert方法配合使用）void assertCurrentActivity (String message, Class activityClass ,boolean is

29、NewInstance)断言当前的activity是否是预期的参数：message-如果运行失败打印的消息activityClass-预期的activityisNewInstance-可选项，实际activity是否是预期activity的继承，如果为true则只要是继承关系就通过，false则必须是当前activity返回：无 void assertCurrentActivity (String message, String name ,boolean isNewInstance)断言当前的activity是否是预期的参数：message-如果运行失败打印的消息name-预期activit

30、y的名字isNewInstance-可选项，实际activity是否是预期activity的继承，如果为true则只要是继承关系就通过，false则必须是当前activity返回：无void assertMemoryNotLow()断言目前系统可用内存是否过低，内存空间足够则通过返回：无is方法boolean isCheckBoxChecked (int index | String text)判断checkBox是否处于被选中的状态，可以通过index和text两种方法定位参数：index-检查的checkBox的索引值，如果只有一个可用则为0text-检查的checkBox的文字，可使用正

31、则表达式返回：true-如果被选中false-如果没有被选中boolean isRadioButtonChecked (int index | String text)判断RadioButton是否处于被选中的状态，可以通过index和text两种方法定位参数：index-检查的RadioButton的索引值，如果只有一个可用则为0text-检查的RadioButton的文字，可使用正则表达式返回：true-如果被选中false-如果没有被选中boolean isRadioButtonChecked (int index | String text)判断RadioButton是否处于被选中的状

32、态，可以通过index和text两种方法定位参数：index-检查的RadioButton的索引值，如果只有一个可用则为0text-检查的RadioButton的文字，可使用正则表达式返回：true-如果被选中false-如果没有被选中boolean isToggleButtonChecked (int index | String text)判断ToggleButton是否处于被选中的状态，可以通过index和text两种方法定位参数：index-检查的ToggleButton的索引值，如果只有一个可用则为0text-检查的ToggleButton的文字，可使用正则表达式返回：true-如果

33、被选中false-如果没有被选中boolean isSpinnerTextSelected ( int index, String text)判断SpinnerText是否处于被选中的状态，可以通过index定位参数：index-检查的SpinnerText的索引值，如果只有一个可用则为0text-检查的SpinnerText的文字，可使用正则表达式返回：true-如果被选中false-如果没有被选中boolean isTextChecked (String text)判断text是否处于被选中的状态，可以通过text定位参数：text-检查的text的文字，可使用正则表达式返回：true-如

34、果被选中false-如果没有被选中search方法boolean searchButton (String text , int minimumNumberOfMatches, boolean onlyVisible)判断当前的屏幕中是否能找到指定的button参数：text-查找的button的文字minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个onlyVisible-只记录可见的返回：true-如果找到了该控件false-如果没有找到该控件boolean searchText (String text , int minimumNumberOfMat

35、ches, boolean scroll, boolean onlyVisible)判断当前的屏幕中是否能找到指定的text，即文本参数：text-查找的Text的文字minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找onlyVisible-只记录可见的返回：true-如果找到了该文本false-如果没有找到该文本boolean searchToggleButton (String text , int minimumNumberOfMatches)判断当前的屏幕中是否能找

36、到指定的ToggleButton参数：text-查找的ToggleButton的文字minimumNumberOfMatches-最小指定多少才算是通过，0表示1个或者多个返回：true-如果找到了该控件false-如果没有找到该控件boolean searchEditText (String text)判断当前的屏幕中是否能找到指定的EditText参数：text-查找的Text的文字返回：true-如果找到了该文本false-如果没有找到该文本Robotium API 翻译（四）等待执行的方法sleep、waitFor分类：robotium2014-02-13 10:51896人阅读评论(

37、0)收藏举报robotium测试中经常出现明明有控件或者文本，但是由于界面没有载入完成或者其他原因导致assert判断的结果失败。或者两次执行，一次成功，一次失败的情况。所以需要加入这些等待某些控件或者文本载入的方法，以加强程序执行的健壮性。sleep是固定长度时间的等待，waitFor则是等待某个控件或者文本载入后再进行下一步操作。故两者都能用的情况下，推荐waitForsleep，固定时间的等待void sleep(int time)让测试停止若干时间以便进行下一步操作参数：time-停止的时间，单位是毫秒，如sleep(2000)，是停止了2秒钟返回：无waitFor，等待特定的某个控件

38、或者文本载入后再进行下一步操作boolean waitForActivity ( Class activityClass | String name , int timeout)等待某个activity载入以进行下一步操作参数：activityClass-定位activity的classname-定位activity的名称timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前出现了activityfalse-过了失效时间仍未找到boolean waitForView ( Class viewClass , int timeout, bo

39、olean scroll)等待某个view载入以进行下一步操作，通过view的class定位参数：viewClass-定位view的classtimeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找返回：true-在失效时间前出现了viewfalse-过了失效时间仍未找到boolean waitForView (int id , int minimumNumberOfMatches, int timeout, boolean scroll)等待某个view载入以进行下一步操作，通过v

40、iew的id定位参数：id-定位view的idminimumNumberOfMatches-最小指定多少才可以往下进行，0表示1个或者多个timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找返回：true-在失效时间前出现了viewfalse-过了失效时间仍未找到boolean waitForView ( android.view.View.view view , int timeout, boolean scroll)等待某个view载入以进行下一步操作，通过view名称定位参

41、数：view-定位view的名称timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找返回：true-在失效时间前出现了viewfalse-过了失效时间仍未找到boolean waitForText (String text , int minimumNumberOfMatches, int timeout, boolean scroll, boolean onlyVisible)等待某个文本载入以进行下一步操作参数：text-等待的文本minimumNumberOfMatches

42、-最小指定多少才可以往下进行，0表示1个或者多个timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找onlyVisible-只有可见的才会被统计返回：true-在失效时间前出现了viewfalse-过了失效时间仍未找到boolean waitForDialogToOpen(int timeout)等待对话框打开参数：timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前打开了dialogfalse-过了失效时间仍未打开bo

43、olean waitForDialogToClose(int timeout)等待对话框关闭参数：timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前关闭了dialogfalse-过了失效时间仍未关闭boolean waitForWebElement (By by , int minimumNumberOfMatches, int timeout, boolean scroll)等待某个web控件载入以进行下一步操作参数：by-定位web控件的by属性minimumNumberOfMatches-最小指定多少才可以往下进行，0表示1个

44、或者多个timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒scroll-是否允许滚动搜索，true表示支持，false表示只能在当前屏幕内查找返回：true-在失效时间前出现了web控件false-过了失效时间仍未找到boolean waitForFragmentById (int id , int timeout)等待Fragment载入以进行下一步操作，以id定位Fragment参数：id-定位Fragment的idtimeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前出现了Fragmentfals

45、e-过了失效时间仍未找到boolean waitForFragmentByTag (String id , int timeout)等待Fragment载入以进行下一步操作，以tag定位Fragment参数：tag-定位Fragment的tagtimeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前出现了Fragmentfalse-过了失效时间仍未找到boolean waitForLogMessage (String logMessage , int timeout)等待日志信息载入以进行下一步操作参数：logMessage-等待加载的日

46、志timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前出现了logMessagefalse-过了失效时间仍未找到boolean waitForCondition (Condition condition, int timeout)等待某种条件加载以进行下一步操作参数：condition-需要满足的条件timeout-失效时间，如果过了这个时间就不再等待，认为失败。单位毫秒，默认20秒返回：true-在失效时间前出现了满足condition的条件false-过了失效时间仍未找到注：Condition是一个interface，里面只有一个

47、方法isSatisfied () ，用于多条件的等待Robotium API 翻译（五）web控件测试方法，WebElement和By类分类：robotium2014-02-13 11:531136人阅读评论(0)收藏举报robotium在Robotium中，可以通过id、index、控件名称或者对应的text正则表达式来定位一个本地的控件。那么对于外部的web控件来说，在你的程序里面无法像本地控件一样找到id、index什么的，怎么来定位呢？其实Robotium提供了定位web控件的类和方法，分别在By和Solo里面。其中By是专门用来定位web属性的，Solo里面部分方法是可以用于web控件的，部分方法是专门为了web控件设置的。大家可以使用PC端的浏览器模拟User-Agent为android手机的方式，来查看web控件的属性。Chrome有自带的User-Agent模拟，FireFox需要下载插件才可以。我就是用的FireFox的插件，如下图：By里面的方法介绍By id(String id)通过id来定位一个WebElement，最常用的方法，一般来说是首选。参数：id-WebElement的id返回值By-定位的WebElementBy n