iOS UI自动化——Instruments常用语法

1.理解UIAElement层级关系

• UIAElement层级的最顶层是UIATarget类，相当于你的设备或模拟器，该类具有管理和访问你的设备相关信息的基本功能。要想获得你的target，你可以使用以下的代码：

      var target = UIATarget.localTarget();

• 获得你的application，对应于UIApplication:

      var app = target.frontMostApp();

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

      var window = app.mainWindow();

• 打印UIAElement层级关系

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

   UIATarget.localTarget().logElementTree();

2.模拟用户动作

• 单击操作

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

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

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

• 其他一些动作

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

•  输入文本

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

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

3.简洁实用的日志功能

• 至少，你应该在每一次脚本运行的开始和结束打上日志（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 (var j = 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 (var i = 0; i < 5; i++) { 

}

if (i == 0) {

}