ios instruments Automation UIATarget

1、调用外部的js文件

＃import "...filePath/fileName.js"

2、获得当前程序窗口

var target = UIATarget.localTarget();//获得目标程序

var window = target.frontMostApp().mainWindow();//获得当前窗口

说明：大部分程序中组建都是在window窗口下操作的，如：button、textfield等等，因此要想获得这些组建，必须先获得窗口，另外有些组建与window是平级的，写代码 时需要注意，如：tabBars、toolbar、navigationBar等等；

3、按钮点击

UIATarget.localTarget().frontMostApp().mainWindow().buttons()["xxx"].tap();

buttons是UIAElementArray数据类型，因此“xxx”可以表示为按钮在数组中的下标，通过下标就能操作任意当前界面的按钮，“xxx”也可以表示按钮的title，这样能更精准的控制按钮的action；

4、等待系统反映

UIATarget.localTarget().delay(2);//延时2秒执行下一条指令

UIATarget.localTarget().pushTimeout(2);//指定超时为2秒钟

UIATarget.localTarget().popTimeout();//超时弹出

程序运行过程中的速度，收到很多情况的影响，如网速、内存使用率、程序内部延时等等，这些都有可能影响到下一个自动操作步骤，一个指令因为延时而没完成，又开始下一个指令，特别是更换界面，肯定回出错的，脚本并不是“文化青年”没这么聪明，因此要给他设定一个等待时间差；

5、导航栏操作

UIATarget.localTarget().frontMostApp().navigationBar().leftButton().tap(); //点击左侧按钮

UIATarget.localTarget().frontMostApp().navigationBar().rightButton().tap(); //点击右侧按钮

可以发现上面的指令中没有"window()",因为上面介绍了，navigationBar()是与window()平级的；

6、截图

UIATarget.localTarget().captureScreenWithName(“picname”);

7、给textFiled负值

UIATarget.localTarget().frontMostApp().mainWindow().textFields()[0].setValue(“xxx”);

下面是cell中的textField

UIATarget.localTarget().frontMostApp().mainWindow().tableViews()["xxx"].cells()["xxx"].textFields()[0].setValue(“xxx”);

8、虚拟键盘操作

UIATarget.localTarget().frontMostApp().keyboard().typeString(“xxx”);

9、打印屏幕上的控件树结构

UIATarget.localTarget().logElementTree();

这条指令能够将当前界面的所有控件都打印出来，也能从中分析他们的层次结构，方便对控件查看操作；

10、scrollView拖动操作

window.tableViews()[0].scrollDown();

window.tableViews()[0].scrollUp();

window.tableViews()[0].scrollLeft();

window.tableViews()[0].scrollRight();

11、根据title匹配控件

obj＝ window.tableViews()[0].cells().firstWithName(“xxx”);

返回title为“xxx”的控件；

12、根据k值匹配

obj= window.tableViews()[0].cells().firstWithValueForKey(“aaa”,”name”);

13、根据name查询控件

obj= window.tableViews()[0].cells().firstWithPredicate(“name beginswith ‘hello’”);

14、滚轮拖动

UIATarget.localTarget().frontMostApp().mainWindow().pickers()[0].wheels()[0].dragInsideWithOptions({startOffset:{x:0.38, y:0.66}, endOffset:{x:0.38, y:0.12}, duration:1.6});

15、获取文本字符串

UIATarget.localTarget().frontMostApp().mainWindow().scrollViews()[0].staticTexts()[0].value();

16、获取对象数组长度

UIATarget.localTarget().frontMostApp().mainWindow().buttons().length;

对于UIAElementArray类型的数据，通过上面的方法就能够查看数组中的元素个数；

17、segmentedControls控件

UIATarget.localTarget().frontMostApp().mainWindow().elements()[0].segmentedControls()[0].buttons()[1].tap();

18、slider控件

UIATarget.localTarget().frontMostApp().mainWindow().sliders()[0].dragToValue(xxx);

"xxx"数据范围0～1

19、界面任意位置点击

UIATarget.localTarget().tap({x:100, y:200});//屏幕(x,y) 坐标单击

UIATarget.localTarget().doubleTap({x:100, y:200});//屏幕(x,y) 坐标双击

UIATarget.localTarget().twoFingerTap({x:100, y:200});//双手指点击

20、捏合与放大

UIATarget.localTarget().pinchOpenFromToForDuration(({x:20, y:200}, {x:300, y:200}, 2);//在2秒钟内,指定坐标的放大

UIATarget.localTarget().pinchCloseFromToForDuration(({x:20, y:200}, {x:300, y:200}, 2);//在2秒钟内,指定坐标缩小

UIATarget.localTarget().dragFromToForDuration(({x:160, y:200}, {x:160, y:400}, 1);//1秒钟内拖拽坐标位置

UIATarget.localTarget().flickFromTo(({x:160, y:200}, {x:160, y:400});//快速的拖拽,没有时间参数

21、获取导航按钮名字

var tabBar = UIATarget.localTarget().frontMostApp().mainWindow().tabBar();

var selectedTabName = tabBar.selectedButton().name();

name()函数是个只读函数；

22、scrollView定位

UIATarget.localTarget().frontMostApp().mainWindow().tableViews()[0].scrollToElementWithPredicate("name beginswith ‘Turtle Pie’");

滚动到表格名字以Turtle Pie开头的地方.名字可是不确定的,可以用这个方法来定位.

scrollToElementWithName() 名字确定的位置

scrollToElementWithValueForKey()值确定的位置.

23、测试日志纪录

var testName = "Module 001 Test";

UIALogger.logStart(testName);//测试开始//some test code

UIALogger.logMessage("Starting Module 001 branch 2, validating input.");//中间加的测试日志,用来给自己区分测试内容和位置等变量

UIATarget.localTarget().captureScreenWithName("SS001-2_AddedIngredient");//抓取当前测试的屏幕保存名字为:SS001-2_AddedIngredient

UIALogger.logPass(testName);////测试结束,给的测试标记

24、alert控件

UIATarget.onAlert = function onAlert(alert) {

var title = alert.name();

UIALogger.logWarning("Alert with title '" + title + "' encountered.");

if (title == "The Alert We Expected") {

alert.buttons()["Continue"].tap();

return true; //处理警告,返回true,跳过默认的处理方法

}

return false;//返回false,使用默认的处理方法.

}

25、设置设备旋转

设备方向：

UIATarget.setDeviceOrientation 用来设置 设备方向

UIA_DEVICE_ORIENTATION_UNKNOWN 设备的方向不能确定。

UIA_DEVICE_ORIENTATION_PORTRAIT 设备Home键在底部的。

UIA_DEVICE_ORIENTATION_PORTRAIT_UPSIDEDOWN 设备Home键在顶部。

UIA_DEVICE_ORIENTATION_LANDSCAPELEFT 设备Home键在右侧。(这二个地方,不知道是不是官方的xcode写错了,好象写反了,没有求证)

UIA_DEVICE_ORIENTATION_LANDSCAPERIGHT 设备Home键在左侧。

UIA_DEVICE_ORIENTATION_FACEUP 设备是屏幕地平朝上。

UIA_DEVICE_ORIENTATION_FACEDOWN 设备是屏幕地平朝下。

界面方向

UIATarget.interfaceOrientation 设置界面方向

UIA_INTERFACE_ORIENTATION_PORTRAIT 界面是纵向模式下，Home按钮的底部。

UIA_INTERFACE_ORIENTATION_PORTRAIT_UPSIDEDOWN 界面是纵向模式下，但倒过来，Home按钮的顶部。

UIA_INTERFACE_ORIENTATION_LANDSCAPELEFT 该界面是在横向模式下，Home按钮的左侧。

UIA_INTERFACE_ORIENTATION_LANDSCAPERIGHT 该界面是在横向模式下，Home按钮的右侧。

26、程序后台延时

UIATarget.localTarget().deactivateAppForDuration(10);

模拟另一个程序级别更高,占用了当前正在运行的程序.(如电话等功能),10秒后返回本测试程序.

尊重原创----转自：http://blog.sina.com.cn/s/blog_7c336a830101c228.html