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安装成功了)。
3.2)地址后面添加/status可以查看当前设备(你使用的哪个设备运行,就是哪个设备的状态)的状态。---http://localhost:8300/status,获取与wda通信session id
3.3)地址后添加/inspector即可打开WDA 的inspector (非Appium inspector),查看元素:-----http://localhost:8300/inspector ,点击下图中“home”后手机屏幕会切回到主屏幕。-------至此安装WDA以及连接IOS手机成功!!
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
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/[email protected]@appium-webdriveragent/Inspector/js/app.js Unexpected token (67:6)。
-- --解决:点击查看解决方案
3)打开Appium客户端,开启服务后点击启动检查器(inspector)会话,在 Desired Capabilities 中输入相关的参数后点击Start Session,运行成功后,会弹出一个控制界面,在该界面中可以控制手机上正在运行的程序,点击界面上方中心的录制按钮,可以将你对手机端的操作代码化
4)编写python测试用例