WDA: WebDriverAgent的简称，是Facebook为苹果开发的一个自动化测试框架
1、从github中克隆WebDriverAgent项目（cd到自定义的文件夹下下载）
git clone https://github.com/facebook/WebDriverAgent
2、运行初始化脚本
# 进入到WDA 根目录
cd WebDriverAgent/
# 运行初始化脚本
./Scripts/bootstrap.sh
⚠️若执行./Scripts/bootstrap.sh时报错：如下图所示：
ImportDeclaration should appear when the mode is ES6 and in the module context.
AssertionError [ERR_ASSERTION]: ImportDeclaration should appear when the mode is ES6 and in the module context.
------解决：升级eslint ： $ npm install -save eslint, 安装后还是报错--后续再解决。
3、证书配置
免费、付费账号均可，修改bundleID，与其他人不同即可，随意设置。
1）Xcode打开WebDriverAgent目录下的WebDriverAgent.xcodeproj文件。按照下图进行操作：
⚠️ 1: 但是会提示问题，如上图所示：
问题：The app ID "com.facebook.WebDriverAgentRunner" cannot be registered to your development team. Change your bundle identifier to a unique string to try again.
解决：请进入WebDriverAgentRunner -> Build Settings设置中，找到Packaging中的选项，将其内容修改为唯一识别的字符串就不报错了，如下图所示：
4、运行与测试
1）iphone手机连接Mac，并添加信任
设置=》通用=》设备管理=》开发者应用=》验证应用
2）选择如下图后运行( 直接command+U运行，这是test模式，不能run，即一定要执行project>Test 才可以校验第三步)， 运行后会提示输入mac电脑的密码，提示编译成功，并且在IOS真机上看到了WDA的身影。
选择
编译成功
3）WDA安装校验（前提是project>Test 运行的，如下图所示）
编译成功的同时，控制台会显示输出IP地址和端口，如下图所示（打开控制台方法：选择view->Debug Area->Activate console打开底部控制台。）：关键是最后一句话（ServerURLHere->http://192.168.11.236:8100<-ServerURLHere）
3.1）复制url到输入在浏览器中，就会发现网页上显示出你的手机界面，然后，你就可以为所欲为啦。
不过有些iPhone，据说是国产的原因，直接使用ip不能连接手机（即输入打印出来的url无法显示手机界面），需要进行端口转发（终端执行 “iproxy 8300 8100” 回车后在浏览器中输入http://localhost:8300/出现json字符串即表示成功，同时说明WDA安装成功了）。
http://localhost:8300
3.2）地址后面添加/status可以查看当前设备（你使用的哪个设备运行，就是哪个设备的状态）的状态。---http://localhost:8300/status，获取与wda通信session id
http://localhost:8300/status
3.3）地址后添加/inspector即可打开WDA 的inspector （非Appium inspector），查看元素：-----http://localhost:8300/inspector ，点击下图中“home”后手机屏幕会切回到主屏幕。-------至此安装WDA以及连接IOS手机成功！！
http://localhost:8300/inspector
5、进阶：如何用命令启动webDriverAgent，即终端替代xcdode
------小结：1⃣️start_webDriverAgent.sh 2⃣️proxy 8300 8100
5.1）进入webDriverAgent目录，创建start2019.sh文件：
$ touch start2019.sh # 创建文件
5.2）vi （$ vi start2019.sh）输入以下内容:---这样就将启动webDriverAgent的命令保存在了start.sh文件中了!!
# 解锁keychain，以便可以正常的签名应用
PASSWORD="123"
security unlock-keychain -p $PASSWORD ~/Library/Keychains/login.keychain
# 获取设备的UDID
UDID=$(idevice_id -l | head -n1)
# 运行测试
xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination "id=$UDID" test
# [可选] 部分国产苹果手手机无法访问url，需要端口转发 ----貌似不执行，还是需要手动转发！！
iproxy 8300 8100
图中8100已改为8300
5.3）执行start2019.sh文件
$ chmod 777 start2019.sh # 修改文件start.sh 的权限,使用命令：
$ ./start2019.sh # 执行start.sh文件
5.4）验证WDA是否启动成功
情况一：非国产手机，直接复制上面的url到浏览器中即可访问。
情况二：国产手机或者复制url无法打开页面的情况时：
$ proxy 8300 8100 #开启iproxy 进行端口转发
浏览器中输入：http://localhost:8300 ，出现遗传json字符串即可。
// 更方便些的话，直接在终端打开时的默认路径下新建这个执行文件，然后文件中切换路径到WebDriverAgent下即可，如下图所示。
第一行新增：# 切换到webDriverAgent目录下 cd xcode_workspace/WebDriverAgent
6、替换Appium中的WebDriverAgent
1）进入到Appium中的WebDriverAgent目录，目录路径如下：
1.15.1版本：/usr/local/lib/node_modules/appium/node_modules/appium-webdriveragent
旧版本本：/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/
2）用刚刚运行成功的WebDriverAgent里的内容替换到appium-webdriveragent下。替换完成后要进入appium-webdriveragent目录，执行：
$ mkdir -p Resources/WebDriverAgent.bundle
$ sh ./Scripts/bootstrap.sh
⚠️遇到问题：ERROR in ./js/app.js Module parse failed: /usr/local/lib/node_modules/appium/node_modules/_appium-webdriveragent@1.3.5@appium-webdriveragent/Inspector/js/app.js Unexpected token (67:6)。
-- --解决：点击查看解决方案
3）打开Appium客户端，开启服务后点击启动检查器（inspector）会话，在 Desired Capabilities 中输入相关的参数后点击Start Session，运行成功后，会弹出一个控制界面，在该界面中可以控制手机上正在运行的程序，点击界面上方中心的录制按钮，可以将你对手机端的操作代码化
4）编写python测试用例
网友评论