Windows上实现iOS APP自动化测试：tidevice + WDA + facebook-wda / appium
<p>本文介绍如何在Windows下构建iOS APP自动化测试环境，采用的主要工具为tidevice，WebDriverAgent，facebook-wda或者appium。</p><p></p><div class="toc"><div class="toc-container-header">目录</div><ul><li>测试架构介绍<ul><li>WebDriverAgent原理分析</li><li>tidevice原理分析</li></ul></li><li>iOS 设备安装 wda<ul><li>1、安装Xcode</li><li>2、下载WebDriverAgent</li><li>3、Xcode打开WebDriverAgent</li><li>4、Xcode添加开发者帐户</li><li>5、项目配置</li><li>6、项目构建及测试</li></ul></li><li>安装iTunes</li><li>安装tidevice</li><li>启动WDA</li><li>appium自动化（未成功）</li><li>facebook-wda自动化</li><li>常见问题</li></ul></div><p></p>
<h1 id="测试架构介绍">测试架构介绍</h1>
<p>下面是本文搭建的iOS自动化测试架构原理图：</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203507864-932575708.png"> </div>
<ol>
<li>手机端的WDA Runner（WebDriverAgent）类似于appium测试框架中的 UIAutomator Server，将从客户端接收到的控制命令转换为XCUITest 相关API操作，实现对应用界面的控制。WebDriverAgent应用需要通过xcode编译安装。</li>
<li>usbmuxd是苹果提供的一个服务，用于USB和TCP协议之间的转换，实现在没有网络的情况下也可以连接设备，iTunes和Xcode就使用到了这个服务，所以在环境安装中需要在windows上安装一个iTunes。</li>
<li>WDA的启动使用阿里开源的tidevice工具。</li>
<li>Language Bindings为不同语言的测试脚本，比如基于python语言的facebook-wda，基于go语言的gwda等。</li>
</ol>
<h2 id="webdriveragent原理分析">WebDriverAgent原理分析</h2>
<p>WebDriverAgent是Facebook 在2015年的 SeleniumConf 大会上推出了一款iOS移动测试框架。它在 iOS 端实现了一个 WebDriver server ，通过这个 server 来实现远程控制 iOS 设备。它主要通过连接XCTest.framework来调用Apple的API实现对设备的操作。</p>
<p>WebDriverAgent采用C/S架构，集成appium使用的WebDriver协议规范，通信协议使用Mobile JSON Wire Protocol。</p>
<ol>
<li>WDAClient：WDA的客户端，测试库facebook-wda 就是 WDA 的 Python 客户端库，通过HTTP协议（Mobile JSON Wire Protocol）与WebDriverAgent进行通信。</li>
<li>WebDriverAgentRunner：运行在手机上的WDA server，默认监听端口为8100，主要功能包括①接收WDAClient的请求并将操作命令发送给XCTest.framework。②将响应发送给WDA Client</li>
</ol>
<h2 id="tidevice原理分析">tidevice原理分析</h2>
<p>前面介绍了iOS的自动化需要通过WebDriverAgent来实现，一种常见的解决方案是使用xcodebuild来启动WebDriverAgent，而xcode需要Mac系统，也就是必须在MAC上进行iOS自动化测试。</p>
<p>tidevice 是阿里开源的一个基于Python的iOS自动化工具，通过逆向iOS通信协议，模拟xcodebuild与手机进行通信，向手机发送特定的指令，来启动WDA，从而可以脱离Mac电脑，能够在Linux、Windows上运行iOS自动化。tidevice基于python实现了libimobiledevice中的功能。</p>
<p>tidevice通过usbmuxd与手机通信来启动WDA，通过建立一个TCP连接到usbmuxd的/var/run/usbmuxd TCP端口，然后usbmuxd将请求发送到USB连接的iPhone上。上面提到的libimobiledevice就是一个跨平台的用于与iOS设备进行通信的库。</p>
<h1 id="ios-设备安装-wda">iOS 设备安装 wda</h1>
<p>本文所用的环境：</p>
<ul>
<li>
<p>macOS版本：macOS Big Sur 11.4</p>
</li>
<li>
<p>Xcode版本：Version 12.5.1 (12E507)</p>
</li>
<li>
<p>iOS 设备： iPhone12 mini（14.6）</p>
</li>
<li>
<p>Windows系统版本：Windows 10 家庭中文版</p>
</li>
</ul>
<h2 id="1安装xcode">1、安装Xcode</h2>
<p>app store 下载安装iOS开发环境Xcode。</p>
<h2 id="2下载webdriveragent">2、下载WebDriverAgent</h2>
<p>使用appium维护的WebDriverAgent，项目地址：https://github.com/appium/WebDriverAgent。</p>
<pre><code class="language-sh">$ git clone https://github.com/appium/WebDriverAgent.git
</code></pre>
<p>现在不需要执行下面的脚本了，作者已经删除：</p>
<pre><code class="language-sh">$ ./Scripts/bootstrap.sh
</code></pre>
<h2 id="3xcode打开webdriveragent">3、Xcode打开WebDriverAgent</h2>
<p>双击WebDriverAgent中的WebDriverAgent.xcodeproj文件，这是一个xcode项目文件。</p>
<h2 id="4xcode添加开发者帐户">4、Xcode添加开发者帐户</h2>
<p>Xcode -> Preference</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203555015-1306900962.png"> </div>
<h2 id="5项目配置">5、项目配置</h2>
<p>设置Team为你添加的帐户，修改Bundle Identifier为唯一名称</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203608295-742847100.png"> </div>
<p>设置完成后，选择Scheme为WebDriverAgentRunner</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203616327-1867731951.png"> </div>
<p>选择Destination为你连接的iPhone。</p>
<h2 id="6项目构建及测试">6、项目构建及测试</h2>
<p>然后点击左上角的三角符号进行build，或者点击Product -> Build；</p>
<p>Build成功之后，点击Product -> Test；</p>
<p>可以看到WebDriverAgent安装到了你的iPhone上</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203526527-1726334514.png"> </div>
点击iPhone上的设置-> 通用 -> 设备管理 信任开发者APP
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203625362-538214434.png"> </div>
<p>以上是我的WDA安装配置过程，如果有问题可以参考文档：https://github.com/appium/appium-xcuitest-driver/blob/master/docs/real-device-config.md</p>
<h1 id="安装itunes">安装iTunes</h1>
<p>因为iTunes里面有usbmux驱动，需要安装一下它。</p>
<p>下载安装Windows 版 iTunes方法：https://support.apple.com/zh-cn/HT210384</p>
<p>iTunes安装成功后，连接上你的iPhone：</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203638103-50004310.png"> </div>
<h1 id="安装tidevice">安装tidevice</h1>
<p>tidevice用于启动WDA，它可以运行在Windows上，也支持Mac和Linux。项目地址：https://github.com/alibaba/taobao-iphone-device。 要求Python版本3.6+。</p>
<p>pip安装tidevice：</p>
<pre><code class="language-sh">$ pip3 install -U "tidevice"
</code></pre>
<p>查看是否安装成功：</p>
<pre><code class="language-sh">$ tidevice version
tidevice version 0.4.14
</code></pre>
<p>列出连接设备</p>
<pre><code class="language-sh">$ tidevice list
List of apple devices attached
00008101-000255021E08001E iPhone11
$ tidevice list --json
[
{
"udid": "00008101-000255021E08001E",
"name": "iPhone11"
}
]
</code></pre>
<p>查看设备信息</p>
<pre><code class="language-sh">$ tidevice info
</code></pre>
<p>tidevice的更多使用方法可参考https://github.com/alibaba/taobao-iphone-device#readme 。</p>
<h1 id="启动wda">启动WDA</h1>
<p>查看安装的WDA应用：</p>
<pre><code class="language-sh">$ tidevice applist
com.apple.store.Jolly Apple Store 509000
com.apple.Keynote Keynote 讲演 10.1
com.facebook.WebDriverAgent.XXXXXtest.xctrunner WebDriverAgentRunner-Runner 1.0
com.apple.Numbers Numbers 表格 10.1
com.apple.iMovie iMovie 剪辑 229
com.apple.mobilegarageband 库乐队 2.3.8
com.apple.clips 可立拍 2.1.1
com.apple.Pages Pages 文稿 10.1
</code></pre>
<p>使用tidevice启动WDA</p>
<pre><code class="language-sh">$ tidevice -u [设备 udid] wdaproxy -B --port 8100 # 运行 XCTest 并在PC上监听8100端口
</code></pre>
<ul>
<li>UDID（ Unique Device Identifier）是iOS设备的唯一识别码，可以通过xcode中查看，也可以使用上面介绍的<code>tidevice list</code>命令。</li>
<li>Bundle ID（Bundle identifier）为应用 ID，是iOS应用的唯一标识。是你编译WDA应用设置的名称，可通过<code>tidevice applist</code>命令查看。</li>
<li>手机设备中 wda 的默认监听端口为8100，此命令将手机的8100端口映射到了PC上的8100端口。</li>
<li><code>tidevice xctest --debug</code>：可用于查看详细日志</li>
</ul>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203651253-1824448742.png"> </div>
<p>浏览器访问http://127.0.0.1:8100/status 可以看到手机的状态信息。</p>
<pre><code class="language-json">{
"value" : {
"message" : "WebDriverAgent is ready to accept commands",
"state" : "success",
"os" : {
"testmanagerdVersion" : 28,
"name" : "iOS",
"sdkVersion" : "14.5",
"version" : "14.6"
},
"ios" : {
"ip" : "192.168.102.47"
},
"ready" : true,
"build" : {
"time" : "Jul 17 2021 18:57:32",
"productBundleIdentifier" : "com.facebook.WebDriverAgentRunner"
}
},
"sessionId" : "EAB73269-5D5B-45EB-913B-2BAA21FE2830"
}
</code></pre>
<p>测试一下用tidevice打开iPhone的【设置】：</p>
<pre><code class="language-sh">$ tidevice launch com.apple.Preferences
</code></pre>
<p>其中【设置】的Bundle ID可通过如下命令查看：</p>
<pre><code class="language-sh">$ tidevice ps
$ tidevice ps --json
</code></pre>
<h1 id="appium自动化未成功">appium自动化（未成功）</h1>
<p>参考：https://testerhome.com/topics/29230</p>
<p>安装appium：https://github.com/appium/appium-desktop/releases。 我安装的版本是1.21.0</p>
<p>安装完成后启动Appium</p>
<p>配置信息：</p>
<pre><code class="language-sh">{
"platformName": "ios",
"platformVersion": "14.6",
"deviceName": "iPhone11",
"udid": "00008101-000255021E08001E",
"bundleId": "com.facebook.WebDriverAgent.XXXXXtest.xctrunner",
"webDriverAgentUrl": "http://127.0.0.1:8100",
"noReset": true,
"usePrebuiltWDA": false,
"useXctestrunFile": false,
"skipLogCapture": true,
"automationName": "XCUITest"
}
</code></pre>
<p>配置完成后点击【Start Session】，发现连不上，查看日志报如下错误信息：</p>
<pre><code class="language-sh">WDA is not response in 30 second, check again after 1s
</code></pre>
<p>在issue里面也有人遇到这个报错，他们是概率性的，我失败的概率是100%，完全连不上，折腾一会，还是没解决，果断放弃（后面解决了再更新上来），怀疑是我的WDA安装有问题，但尝试使用facebook-wda进行自动化测试，发现是OK的，遂再次放弃appium。</p>
<h1 id="facebook-wda自动化">facebook-wda自动化</h1>
<p>facebook-wda基于python语言，没有像appium那样启动一个中间服务appium server，这也是appium支持多语言的原因。facebook-wda相比appium更加简洁，功能也比较多，appium有的功能基本都提供了。</p>
<p>facebook-wda项目地址：https://github.com/openatx/facebook-wda</p>
<p>安装：</p>
<pre><code class="language-sh">pip3 install -U facebook-wda
</code></pre>
<p>测试：</p>
<pre><code class="language-python">import wda
c = wda.Client('http://localhost:8100') # 8100为启动WDA设置的端口号
# c.app_current() # 显示当前应用信息，主要用于获取bundleId，也可以使用tidevice ps 命令
c.session().app_activate("com.apple.Preferences")# 打开设置
# c.session().app_terminate("com.apple.Preferences") # 退出设置
c(name="搜索").set_text("NFC")# 搜索 NFC
c(name="NFC").click() # 点击NFC
c(xpath='//Switch').exists # 判断NFC开关是否存在
c(xpath='//Switch').get().value # 获取NFC开关状态
</code></pre>
<h1 id="常见问题">常见问题</h1>
<p>1、解决iPhone连上MAC之后会不断重连的问题：<br>
杀掉usbd：</p>
<pre><code class="language-sh">$ sudo killall -STOP -c usbd
</code></pre>
<p>2、xcode编译WDA时可能遇到没有指定iOS版本文件，可以尝试下载对应版本的支持文件。（我使用的Xcode 12.5.1 有iOS 14.6）</p>
<p>相应iOS版本支持文件项目地址：https://github.com/iGhibli/iOS-DeviceSupport/tree/master/DeviceSupport</p>
<p>将下载的文件放到下面的目录中：Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport</p>
<p>3、wda Build成功，出现Unable to copy symbols from this device错误</p>
<div align="center"> <img src="https://img2020.cnblogs.com/blog/2229336/202108/2229336-20210807203710992-769518823.png"> </div>
<p>大概率是xcode版本低了，需要升级一下code。</p>
<center><b>--THE END--<b></b></b></center><b><b>
<blockquote>
<p>欢迎关注公众号:「测试开发小记」及时接收最新技术文章！</p>
</blockquote>
</b></b><br><br>
来源：https://www.cnblogs.com/hiyong/p/15113172.html
頁:
[1]