iOS自动化测试：WebDriverAgent接口_悄然林静的博客

终端变量：

DEVICE_URL set as device URL (eg. http://localhost:8100 ) SESSION_ID set as session id. Returned by start session command e.g. D15E12F6-CA23-4CD4-89F9-E5C5EA6F4FAD. If you want to use WebDriverAgent without launching an app you can use the default session ID reported by the /status endpoint. JSON_HEADER='-H "Content-Type: application/json"'
接口测试：

1. 根据bundleId启动iPhone应用

// 请求方法1：curl命令
curl -X POST $JSON_HEADER -d "{\"desiredCapabilities\":{\"bundleId\":\"com.apple.calculator\"}}" http://localhost:7999/session
// 请求方法2：POST
http://localhost:7999/session
// 方法2参数：转成json字符串设置到请求体(HTTPBody)
    "desiredCapabilities":{
        "bundleId":"com.apple.calculator"
// 返回数据
    "value":{
        "state":"success",
        "os":{
            "name":"iOS",
            "version":"11.4.1"
        "ios":{
            "simulatorVersion":"11.4.1",
            "ip":"169.254.184.254"
        "build":{
            "time":"Jul 31 2018 14:59:39"
    "sessionId":"E2431B5B-C14D-409C-890D-A9F2320958CE",
    "status":0
 2. 获取status 
 // 请求方法1：curl命令
curl -X GET $JSON_HEADER $DEVICE_URL/status
// 请求方法2：GET
http://localhost:7999/status    // 7999是iproxy转发到Mac的端口号
// 方法2参数：无
// 返回数据：
    "value":{
        "state":"success",
        "os":{
            "name":"iOS",
            "version":"11.4.1"
        "ios":{
            "simulatorVersion":"11.4.1",
            "ip":"169.254.184.254"
        "build":{
            "time":"Jul 30 2018 10:07:54"
    "sessionId":"C09DE29D-030F-4AD8-85E6-C78E5B38DF8D",
    "status":0
 3. 查询当前会话的sessionId 
 // 思路：先查status，再从中取出sessionId 
 4. 查询当前会话的sessionId 
 // 请求方法1：curl命令
curl -X GET $JSON_HEADER http://localhost:7999/session/E2431B5B-C14D-409C-890D-A9F2320958CE
// 请求方法2：GET
http://localhost:7999/session/E2431B5B-C14D-409C-890D-A9F2320958CE    // 这一长串是sessionId
// 返回数据
    "value":{
        "sessionId":"E2431B5B-C14D-409C-890D-A9F2320958CE",
        "capabilities":{
            "device":"iphone",
            "browserName":"计算器",
            "sdkVersion":"11.4.1",
            "CFBundleIdentifier":"com.apple.calculator"
    "sessionId":"E2431B5B-C14D-409C-890D-A9F2320958CE",
    "status":0
 5. 查询控件的elementId 
 // curl命令
curl -X POST $JSON_HEADER -d "{\"using\":\"xpath\",\"value\":\"//XCUIElementTypeButton[@name='Share']\"}" $DEVICE_URL/session/$SESSION_ID/element
// 举个例子
curl -X POST $JSON_HEADER -d "{\"using\":\"xpath\",\"value\":\"//XCUIElementTypeIcon[@name='微信']\"}" http://169.254.81.109:8100/session/B1C0006C-3C4D-4280-81CC-B7D7F7E44703/elements
// 返回数据
    "value":{
        "ELEMENT":"44B21850-8824-44F2-9208-AEDCCD313F75"
    "sessionId":"B1C0006C-3C4D-4280-81CC-B7D7F7E44703",
    "status":0
 6. 点击控件(click) 
 // curl命令
curl -X POST $JSON_HEADER -d "" $DEVICE_URL/session/$SESSION_ID/element/5/click
// 举个例子
curl -X POST $JSON_HEADER -d "" http://169.254.81.109:8100/session/9A354D8F-052B-4A3F-9888-375F45AE11A1/element/0359FE45-3575-4D6F-B6EE-682028AFEC47/click
// 返回数据
    "status":0,
    "id":"BA7CD7DF-E894-4947-963D-6AC935ACF483",
    "value":"",
    "sessionId":"E2431B5B-C14D-409C-890D-A9F2320958CE"
 7. 将字符串写入文本框 
 // curl命令：逐个字符输入
curl -X POST $JSON_HEADER -d "{\"value\":[\"h\",\"e\",\"l\",\"l\",\"o\",\" \",\"w\",\"o\",\"r\",\"l\",\"d\"]}" $DEVICE_URL/session/$SESSION_ID/element/5/value
// curl命令：一次输入整个字符串
curl -X POST $JSON_HEADER -d "{\"value\":\"hello world\"}" $DEVICE_URL/session/$SESSION_ID/element/5/value
// 举个例子
curl -X POST $JSON_HEADER -d "{\"value\":\"hello world\"}" http://169.254.81.109:8100/session/E0F1C5FB-0BD4-4139-A868-428B9A6E3340/element/415BE367-F59A-437F-8515-B149E25831F3/value
// 返回数据
    "status":0,
    "id":"415BE367-F59A-437F-8515-B149E25831F3",    // 操作的文本框的elementId
    "value":"",
    "sessionId":"E0F1C5FB-0BD4-4139-A868-428B9A6E3340"
 8. 清除文本框内容 
 // curl命令
curl -X POST $JSON_HEADER -d "" $DEVICE_URL/session/$SESSION_ID/element/5/clear
// 举个例子
curl -X POST $JSON_HEADER -d "" http://169.254.81.109:8100/session/E0F1C5FB-0BD4-4139-A868-428B9A6E3340/element/415BE367-F59A-437F-8515-B149E25831F3/clear
// 返回数据
    "status":0,
    "id":"415BE367-F59A-437F-8515-B149E25831F3",
    "value":"",
    "sessionId":"E0F1C5FB-0BD4-4139-A868-428B9A6E3340"
 9. Force Touch(指定控件) 
 // curl命令
curl -X POST $JSON_HEADER -d "{\"pressure\":\"0.8\",\"duration\":\"2.0\"}" $DEVICE_URL/session/$SESSION_ID//wda/element/forceTouchByCoordinate/:uuid
// 举例子
curl -X POST $JSON_HEADER -d "{\"pressure\":\"0.8\",\"duration\":\"2.0\"}" http://169.254.81.109:8100/session/895B7FD8-A4D5-4D30-BABA-1B2072508CF2/wda/element/forceTouch/0885D0F8-1E64-4B9B-901E-CBEE2CB7F856
// 返回数据
    "value":{
    "sessionId":"B1C0006C-3C4D-4280-81CC-B7D7F7E44703",
    "status":0
 9. Force Touch(指定控件&坐标) 
 10. 设定值(PickerWheel、Slider验证可以) 
 // curl命令
curl -X POST $JSON_HEADER -d "" $DEVICE_URL/session/$SESSION_ID/element/5/value
// 举个例子
// 如果是PickerWheel，value可以传单个字符串、字符串数组，其中字符串数组在WDA内部传参时会用空格分隔开再赋值给PickerWheel
// 如果是Slider，要求 0.0 <= value <= 1.0
curl -X POST $JSON_HEADER -d "{\"value\":"0.5"}" http://169.254.81.109:8100/session/2C95EB07-DE96-4A4E-BEA0-3075197AC2ED/element/49B852A6-9C5C-4AB6-B3B0-CF02912794CC/value
// 返回数据
    "value":{
    "sessionId":"2C95EB07-DE96-4A4E-BEA0-3075197AC2ED",
    "status":0
 待验证的接口 
 // Fail：根据bundleId、app参数安装应用
// 原因：app参数格式未知
curl -X POST $JSON_HEADER \
-d "{\"desiredCapabilities\":{\"bundleId\":\"com.apple.mobilesafari\", \"app\":\"[host_path]/magicapp.app\"}}" \
$DEVICE_URL/session
// 移除会话并退出应用
curl -X DELETE $JSON_HEADER $DEVICE_URL/session/$SESSION_ID
// 返回主屏幕
curl -X POST $JSON_HEADER -d "" $DEVICE_URL/wda/homescreen
// 屏幕截图
curl -X GET $JSON_HEADER $DEVICE_URL/screenshot
// 超出时间停止应用
curl -X POST $JSON_HEADER -d "{\"duration\":3}" $DEVICE_URL/session/$SESSION_ID/wda/deactivateApp 
                                    iOS的自动化测试框架可分为两种：注入式和非注入式。注入式的框架通常会提供一些Lib或者是Framework，要求测试人员在待测应用的代码工程中导入这些内容，框架可以通过他们完成对app的驱动，典型的比如monkeytalk。非注入式的框架则是通过苹果提供的instruments工具，调用官方的接口函数，实现对app的相关操作，典型的就是uiautomation，appium注入式：可获取app内的数据；可操作空间大，不受官方限制；可在windows平台进行测试；但是需要在待测项目中增加第三方的部分，使得测试的内容和实际发布的内容并不一致非注入式：待测内容和最终的上线内容保持一致；测试无需源码
一、测试背景概述
随着移动互联网时代的发展，移动终端的自动化测试日益活跃，总体来看在Android平台上的自动化工具和实践比较多，IOS的UI自动化测试由于系统封闭的原因，一直不太成熟。本着不侵入工程和拥抱原生的原则实现一套自动化测试方案。自动化测试节省时间节省真机的成本，而且更高效的覆盖所有的iOS机型测试，避免每次上线前重复的人工回归测试,保证每次上线的版本稳定运行。
二、iOS Appium 原理
经过调研使用Appium进行自动化测试，Appium 是一个自动化测试开源工具，支持 iOS 平台和 Android 平台上的原生应用，web 应用和混合应用。
                                    如果有测试大佬发现内容不对，欢迎指正，我会及时修改。大多数的iOSApp(没有持续集成)迭代流程是这样的也就是说，测试是发布之前的最后一道关卡。如果bug不能在测试中发现，那么bug就会抵达用户，所以测试的完整性和可靠性十分重要。目前，大多数App还停留在人工测试阶段，人工测试投入的成本最低，能够保证核心功能的使用，而且测试人员不需要会写代码。但是，在很多测试场景下，人工测试的效率太低，容易出错。举两个常见的例子：然后，老板就要过来找你了本文所讲解的均是基于XCode8.2.1，有些概念可能不适用于低版本的XCode自动化测试就是写一些测试代码，用代码代替人工去完成模块和业务的测试。其实不管是
                                    安装 WebDriverAgent 之前，需要知道的一、安装 Homebrew1、在此之前先检查电脑上是否有 Ruby 环境， 
终端输入：ruby -v 查看 Ruby 环境 
如果电脑上没有 ruby 或者 ruby 版本太低，查看本篇博客的1和2查看更新Ruby2、终端输入：brew -v 查看 Homebrew 的版本 
结果：Homebrew 1.4.33、如果电脑上没有Homebrew
                                    文章目录前置条件配置连接手机ClientSessionSession 操作  （operations-操作）元素查找元素行为(tap, scroll, set_text等)回调
https://github.com/openatx/facebook-wda
brew install carthage
brew install node
brew install libimobiledevice --HEAD
克隆wda代码
git clone https://githu
WebDriverAgent是适用于iOS 的WebDriver服务器实现；它允许启动和终止应用程序，点击和滚动视图或确认屏幕上的视图状态。这使其成为应用端到端测试或通用设备自动化的完美工具。它通过链接XCTest.framework和调用Apple的API来直接在设备上执行命令。
安装配置WDA服务端:
1.从github上下载WebDriverAgent代码
git clone https...
本文 只要还是 讲下 Mac 如何顺利 编译 出 WebDriverAgent。听说环境搭建坑挺多的。
Mac os 10.11~10.12.(实体机 或者 虚拟机安装都不影响，版本足够就好)
环境准备：
Homebrew
carthage
python
去年的 SeleniumConf 上，Facebook 推出了一款新的iOS移动测试框架 —— WebDriverAgent，当时的推文上，写的还只支持模拟器。半年过过去了，如今在看官方github —— https://gi
                                    写在之前Xcode 7之前，苹果任然保留着automation这个简单上手的自动化测试工具，自需要录制脚本即可，在Xocde 7之后，随着UnitTests加入Xcode之后，这个一个功能就被关闭了，因为UnitTests更强大。前段时间微信的新版本中加入了小程序游戏《跳一跳》，在朋友圈中大火之后，随之就出现了Android和iOS的《跳一跳辅助工具》，偶然了解了一下，发现是通过一个叫《WebDr...