UI Automation之初探UIAElement

【前言】
在iOS自动化测试中UI Automation的对象，都是以UIAxxx的形式出现的，例如UIAButton等。UIA是UI Automation的缩写，如果忽略掉前缀，直接看对象的名称，在表达方面应该会明确。接下来对UI Automation所提供的API进行初步了解。由于xcode8已经不支持 UI Automation，所以苹果官网API文档查不到。根据UI Automation常见语句，初探UIAElement，需要时使用语句即可，暂无必要了解很清楚，避免小白学习前期过于艰难晦涩，下方是整理UI Automation常见语句。个人留底~~

一、理解UIAElement层级关系

1.UIAElement层级的最顶层是UIATarget类，相当于你的设备或模拟器，该类具有管理和访问你的设备相关信息的基本功能。

要想获得你的target，你可以使用以下的代码：

var target =UIATarget.localTarget();

获得你的application，对应于UIApplication:

var app = target.frontMostApp();

获得你的主窗口，对应于UIWindow：

var window = app.mainWindow();

2.打印UIAElement层级关系

你可以使用任意UI控件的logElementTree方法打印出它的所有子元素：

UIATarget.localTarget().logElementTree();

二、模拟用户动作

1.单击操作

UIATarget.localTarget().frontMostApp().navigationBar().buttons()["Add"].tap();

2.对于较复杂的程序，可以精确点击，即确定点击的位置坐标

UIATarget.localTarget().tap({x:100, y:200});

3.其他一些动作

a）单指双击

UIATarget.localTarget().doubleTap({x:100, y:200});

b)双指单击

UIATarget.localTarget().twoFingerTap({x:100, y:200});

C）Pinch动作

UIATarget.localTarget().pinchOpenFromToForDuration({x:20, y:200}, {x:300, y:200}, 2);
UIATarget.localTarget().pinchCloseFromToForDuration({x:20, y:200}, {x:300, y:200}, 2);

d)拖拽动作

UIATarget.localTarget().dragFromToForDuration({x:160, y:200}, {x:160, y:400}, 1);

4.输入文本

var recipeName = "Unusually Long Name for a Recipe";

UIATarget.localTarget().frontMostApp().mainWindow().textFields()[0].setValue(recipeName);

5.调用外部js

#import “../common/common.js

6.导航栏操作

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

7.点击

//按钮点击
UIATarget.localTarget().frontMostApp().mainWindow().buttons()[“xxxxx”].tap();

//坐标点击
UIATarget.localTarget().tap({x:30,y:131});

8.等待n秒，delay(n)

UIATarget.localTarget().delay(3);

9.截图

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

10.获取对象数组长度，length

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

11.获取文本字符串，value()

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

12.滚轮滚动，dragInsideWithOptions()

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});

13.根据name模糊查询控件，firstWithPredicate(“name beginswith ‘xxx'”)

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

14.根据name完全匹配，firstWithName(“xxxx”)

obj= window.tableViews()[0].cells().firstWithName(“hello world”);

15.根据key值匹配，firstWithValueForKey(value,key)

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

16.拖动

window.tableViews()[0].scrollDown();
window.tableViews()[0].scrollUp();
window.tableViews()[0].scrollLeft();
window.tableViews()[0].scrollRight();

17.打印当前屏幕所有空间信息

UIATarget.localTarget().logElementTree();

18.记录日志

UIALogger.logStart(“start”);
UIALogger.logPass(“pass”);
UIALogger.logWarning(“warning”);
UIALogger.logFail(“fail”);
UIALogger.logMessage(“message”);
UIALogger.logError(“error”);
UIALogger.logDebug(“debug”);
UIALogger.logIssue(“issue”);

19.九宫格搜索输入框

UIATarget.localTarget().frontMostApp().mainWindow().searchBars()[0]

20.模拟键盘操作，keyboard().typeString(“xxx”)

UIATarget.localTarget().frontMostApp().keyboard().typeString(“aaa\n”);

21.输入框输入，setValue()

UIATarget.localTarget().frontMostApp().mainWindow().tableViews()[“Empty list”].cells()[“用户名:”].textFields()[0].setValue(“abcd”);

22.屏幕点击

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

23.缩放

// 放大
UIATarget.localTarget().pinchOpenFromToForDuration({x:20, y:200},{x:300, y:200},2);
// 缩小
UIATarget.localTarget().pinchCloseFromToForDuration({x:20, y:200}, {x:300, y:200},2);

24.拖拽与划动

// 拖拽
UIATarget.localTarget().pinchOpenFromToForDuration({x:20, y:200},{x:300, y:200},2);
// 划动
UIATarget.localTarget().pinchCloseFromToForDuration({x:20, y:200}, {x:300, y:200},2);

25.打印

UIALogger.logStart("xxx");
UIALogger.logFail("xxx");
UIALogger.logDebug("xxx");
```

## 三、 简洁实用的日志功能

至少，你应该在每一次脚本运行的开始和结束打上日志（logStart，logEnd），在脚本测试成功或失败时打上日志（logPass，logFail），示例如下：
```
var testName = "Module 001 Test";

UIALogger.logStart(testName);

//你的测试代码

UIALogger.logPass(testName);
```

打印普通信息时，可以使用logMessage，如下：

```
UIALogger.logMessage("Test 1 finished！Test 2 is    beginning……");
```

打印警告信息时，使用logWarning，示例如下：

```
UIALogger.logWarning("Test 1 has some problem！");
```

为了避免纯文本日志的枯燥无味，UIAutomation框架为我们提供了测试过程中的截图功能，可以将你所想要的任意画面甚至是任意指定某一范围的区域截取成图片，并最终输出到日志中去，示例如下：

```
var testName = " Test 1";

UIALogger.logStart(testName);

//一些测试代码

UIALogger.logMessage("Starting test for login……");

//截屏

UIATarget.localTarget().captureScreenWithName("img1   _Login");

//一些测试代码

UIALogger.logPass(testName);

注意：截屏功能只支持真机，若在模拟器中尝试，则会在日志中打印出尝试截屏出错的提示信息
//tableview向下滑动一个屏幕的内容 上下左右

target.frontMostApp().mainWindow().tableViews()[1].scrollDown();

target.frontMostApp().mainWindow().tableViews()[1].scrollUp();

target.frontMostApp().mainWindow().tableViews()[1].scrollLeft();

target.frontMostApp().mainWindow().tableViews()[1].scrollRight();

//tableview按照指定坐标滑动，x，y轴均可设定

target.flickFromTo({x:100,y:400},{x:100,y:20});

//持续向下滑动，tableView和scrollView都可以使用

for(varj = 0; j < 5; j++) {

target.flickFromTo({x:100,y:400},{x:100,y:20});

}

//可见cell的数组里面的第几个

target.frontMostApp().mainWindow().tableViews()[1].visibleCells()[0].tap();

//实际的cell第几个

target.frontMostApp().mainWindow().tableViews()[1].cells()[0].tap();

//scrollView 上下左右滑动一真个屏幕

target.frontMostApp().mainWindow().scrollViews()[0].scrollUp();

target.frontMostApp().mainWindow().scrollViews()[0].scrollDown();

target.frontMostApp().mainWindow().scrollViews()[0].scrollLeft();

target.frontMostApp().mainWindow().scrollViews()[0].scrollRight();

//button 设置下面的属性后，自动测试时可以读取到响应的button

deleteButton.accessibilityLabel=@"press";

//延时语句

UIATarget.localTarget().delay(3);

//支持循环语句 和 if语句

for(vari = 0; i < 5; i++) {

}

if (i == 0) {

}
```