WebDriverAgent重签名爬坑记
接上一篇博文,已经配置好了Xcode环境,那接下来要完成的就是重签名WebDriverAgent。在讲重签名之前,我们还是先来了解下WebDriverAgent,熟悉的朋友,可以直接跳过。
WebDriverAgent
WebDriverAgent简介
这个介绍在开源项目中的README.md有描述,直接搬运过来。
WebDriverAgent简称WDA,WebDriverAgent 是适用于 iOS的WebDriver 服务器实现,可用于远程控制 iOS 设备。它允许您启动和终止应用程序、点击和滚动视图或确认屏幕上的视图存在。这使其成为应用程序端到端测试或通用设备自动化的完美工具。它通过链接XCTest.framework和调用 Apple 的 API 来直接在设备上执行命令。WebDriverAgent 在 Facebook 开发并用于端到端测试,并被Appium成功采用。
目前使用较多的是Appium的WebDriverAgent,但Appium的WebDriverAgent是在FaceBook的基础上开发的。而FaceBook的WebDriverAgent已经很久没更新了,项目处于未维护状态。
WebDriverAgent原理
图引自testerhome,原理如下图所示:
基础工具安装
我相信大家跟我一样,想立即使用Xcode重签名WDA,但执行 ./Scripts/bootstrap.sh
命令后,看到的却是各种报错。所以不要急,按如下步骤,安装一些必要的工具。
安装brew
Homebrew是一个包管理器,用于在Mac上安装一些OS X没有的UNIX工具(比如著名的wget),能在Mac中方便的安装软件或者卸载软件,可以说Homebrew就是mac下的apt-get、yum神器。
安装方式直接敲命令即可
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
我使用这个命令没有成功,换了个命令
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
换了命令成功安装,过程中会有输入电脑密码,按提示操作即可,如下所示:
安装成功后,输入命令 source /Users/hong/.zprofile
使其生效。
安装carthage
使用命令 brew install carthage
即可完成安装,如下所示:
安装node
使用命令 brew install node
即可完成安装
安装WDA依赖
完成上述工具安装后,在WDA目录下,执行命令 ./Scripts/bootstrap.sh
,可能有些朋友会碰到如下报错:
升级 npm
使用命令 npm install -g npm@7.21.0
即可,如下所示:
安装node版本管理模块
还有个报错, ERESOLVE unable to resolve dependency tree
,度娘了下,是npm版本太高,需要降级。但我只安装了node版本管理模块就可以了,命令 sudo npm install n -g
,操作如下:
再执行命令 ./Scripts/bootstrap.sh
,正常编译,没有报错,静候佳音,期间会下各种依赖,如下所示:
依赖安装成功后,会出现build提示,如下所示:
WebDriverAgent重签名
到此,前期准备工作都好了,我们再来配置下Xcode,比如appleid、包名、版本。
登录appleid账号
具体操作如下所示:
选择团队
在 targets 类别中,配置签名团队,这里可选的数据,就是刚才我们登录的账号,如果没有登录,则选不了。操作如下所示:
但选了之后,还会有如下报错信息,如下所示:
如何解决该问题,我们继续来看。需要注意的是,每个包都得选择团队。
配置包名
我们完成的就是重签名,所以需要重新配置个不重复的包名,操作如下所示:
将这里替换掉就好了。需要注意的是,每个包都得修改,而且需要保持一致。
设备版本
重签名时,Xcode选择的ios版本,最好跟本机保持一致,或相近,操作如下所示:
Test
上述配置完成后,选择对应的项目和设备,操作如下:
选择项目:
选择设备:
操作 Product > Test,我们来看结果。
果不其然,使用FaceBook的WDA重签名遇到了以下报错,一一列举,我们来看。
报错总结
报错一
报错信息:Building for iOS, but the linked and embedded framework 'RoutingHTTPServer.framework' was built for iOS + iOS Simulator
解决办法:
在 targets 下的类别中,依次将 Build Settings
里的 Validate Workspace
修改为 Yes
,操作如下所示:
报错二
报错信息:/WebDriverAgent/Carthage/Build/iOS/RoutingHTTPServer.framework/Headers/RouteResponse.h:2:9: Double-quoted include "HTTPResponse.h" in framework header, expected angle-bracketed instead
解决办法:
在 project 的 Info 信息中,将 Quoted Include In Framework Header
修改为 false
,操作如下所示:
报错三
报错信息:/WebDriverAgent/WebDriverAgentLib/Utilities/FBFailureProofTestCase.m:29:1: Implementing deprecated method
解决办法:
将 recordFailureWithDescription
修改为 recordIssue
,操作如下所示:
报错四
报错信息:xcode 编译程序运行,总是提示输入用户名和密码
解决办法:
通过提示框,进入到秘钥配置页面,配置秘钥的访问权限。将自己的秘钥配置成 允许所有应用程序访问此项目 ;或者 添加具体的应用。操作如下所示:
解决了上面四个问题,继续Test,手机上是成功安装了WebDriverAgent,但还是有报错,此报错按度娘中的修改也没有成功。
具体报错如下:
-[UITestingUITests internalImplementation]: unrecognized selector sent to instance 0x2825b1900 (NSInvalidArgumentException)
我比较喜欢折腾,既然FaceBook的不行,那索性就换Appium的试试,换Appium的WDA,竟然直接成功了。可能是之前的错,已经排坑了,所以成功的这么顺滑。
重签名成功后,控制台出现的日志,如下所示:
好了,WDA重签名终于成功了,可以捣鼓ios自动化了,下期再见。
20211210更新
使用appium的wda重签名,可以不执行
./Scripts/bootstrap.sh