Mac版 Xcode+Tagent+airtest环境搭建-详细操作步骤

写在前面:

由于xcode的版本必须高于iPhone手机的版本,最好使用最新版本的xcode,iOS的使用较低版本,否则会一直连接不成功,
可能xcode报错提示:这款iPhone8（型号A1863、A1905、A1906、A1907）运行的是iOS 13.4.1（17E262），此版本的Xcode可能不支持该版本。更新版本的Xcode可以在App Store或开发者.apple.com
或者airtest报错:连接iOS设备失败，请查阅官网[FAQ](https://airtest.doc.io.netease.com/IDEdocs/device_connection/4_ios_connection/)获得更多信息。
从这个报错还看不出什么问题,要排查很久才知道是xcode版本不支持当前的iOS系统...

官方给的文档是:iOS连接https://airtest.doc.io.netease.com/IDEdocs/device_connection/4_ios_connection/
看了下还是不够小白,操作起来还需要请教别人,自己探索后把操作步骤记录了下:

1. 启动Tagent, 下载官方给的文件后,找到WebDriverAgent.xcodeproj这个,双击一下就启动了;
2. 启动xcode,连接手机,此时操作界面如下:显示驱动已经启动,且提示连接设备,点击Generic ios devices,选择自己的iOS手机,点击信任,
3. 
   手机连接成功后界面如下:
   
4. 打开debug信息展示,点击图示箭头展示的图标,打开后在下方就能看到debug信息:

会看到驱动启动成功的信息:2020-08-05 11:01:01.792700+0800 WebDriverAgentRunner-Runner[337:18943] Running tests…
5. 点击顶部Product-Test, 测试本地连接是否成功:


6. 此时打开终端shell窗口,输入:iproxy 8100 8100,回车,可以看到等待连接的提示:MacBook:~ momo$ iproxy 8100 8100
Creating listening port 8100 for device port 8100
waiting for connection
表示接口已经准备好连接了
7. 打开airtest,直接点击右下角的connect按钮即可

可能遇到的问题:

xcode未包含高版本os系统镜像的问题,在驱动启动后连接devices时提示:这款iPhone8（型号A1863、A1905、A1906、A1907）运行的是iOS 13.4.1（17E262），此版本的Xcode可能不支持该版本。更新版本的Xcode可以在App Store或开发者.apple.com,
可以尝试下载高版本的iOS镜像,可以百度一下,名字是DeveloperDiskImage.dmg,DeveloperDiskImage.dmg.signature
进入Tagent目录下,先打开finder,然后复制这个路径/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport,然后可以用快捷键 command+↑+G快捷键进入到相应目录下, 将下载的iOS镜像放在这个目录下.

如果不会用快捷键进入,那就打开终端,输入cd /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport,回车后输入open .
即可打开这个文件夹了.
我用这个办法尝试可以使用11.3.1版本的xcode连接上13.4.1版本的手机了.其实最好xcode版本高于手机版本, 这样就不用这么费劲了.
另外还要注意驱动的打开方式,mac电脑上可以同时安装两个不同版本的xcode,如图:
默认打开方式是低版本的, 但是我们需要的是高版本的xcode打开这个WebDriverAgent.xcodeproj,这里要注意,不然会一直连不上手机.
我试过用11.3.1是好使的.