IOS自动化测试环境搭建（Python & Java）

一、前言

IOS的App自动化测试与Android的一样，也可以用appium来进行。但是IOS自动化依赖苹果的osx系统、Xcode构建等，且封闭的系统需要苹果开发者账号才可以驱动真机。Appium的环境配置有点麻烦，可能大部分时间都在处理各种稀奇古怪的报错，甚至于需要重装系统。

本文旨在记录配置过程（MacOS系统的Python和Java环境配置也有记录），给同道中人提供参考，让大家少走弯路。

二、环境依赖

1、环境依赖项

• Xcode
• Git
• homebrew
• npm、nodejs
• libimobiledevice
• idevicesinstaller
• ios-deploy
• Carthage
• appium
• appium-doctor
• Webdriveragent
• ios-webkit-debug-proxy
• Python和Java
• Android SDK

2、环境需求与支持

需求	版本最低要求	我的环境版本
Mac OSX	10.11+	macOS 11.3.1
iOS	9.3+	13.3、14.7
Xcode	7+	12.5
Appium	1.6+	1.20.2

驱动程序	对应iOS版本
XCUITest Driver	ios9.3或以上
UIAutomation Driver	ios9.3以下

三、环境配置

1、xcode安装

Xcode是运行在操作系统Mac OS X上的集成开发工具（IDE），iOS自动化测试使用Xcode主要用于将绑定了苹果开发者证书的WebDriverAgent打包至iOS手机。

安装方式有两种，根据你的系统版本来选择。

方式一：Mac平台的App Store安装

通过App store安装的Xcode是最新版本，需要最新版macOS系统才能兼容。如果已经升级至最新系统，可以直接在App store下载安装。最好不要升级至最新系统，可能遇到其他兼容性问题。

方式二：离线包安装

你的macOS系统不是最高版本的时候，要保证最低版本需求：macOS在10.12以上，xcode在8.1以上。

离线包下载地址：https://developer.apple.com/cn/support/xcode/ （可以选择版本）

离线包的Xcode版本选择，最好是根据你的系统版本发布时间来定，选发布时间相近的版本。我的版本是：macOS 11.3.1 、Xcode12.5

2、Git安装

安装的Xcode自带Git程序，一般Xcode安装好后不需要再单独安装Git，验证Git环境即可。如果后面的环境依赖安装出现关于Git的报错，需要更新Git，或者卸载重新安装。

验证安装：git --version

验证git连接：ping github.com

能够连接成功时，终端显示：

安装命令：brew install git

更新Git：brew upgrade git

3、Homebrew安装（用brew来安装依赖）

Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令，就可以实现包管理，而不用你关心各种依赖和文件路径的情况，十分方便快捷。类似apt-get、yum。

安装途径有两种：国外源和国内园，推荐使用国内源，我使用国外源没成功过。

方式一（国外源）：

官网：https://brew.sh/

在官网首页复制下面的安装命令，在终端执行命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

验证安装：brew -v

更新Homebrew命令：brew update && brew upgrade && brew clean

方式二（国内源）：

上面的官网安装方法失败率很高，可以采用国内源安装。

homebrew国内源安装方法，终端执行下面的命令：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

终端运行时，根据提示操作：

安装结束后重启终端 或者 运行 source /Users/sinosun/.bash_profile 否则可能无法使用。

终端执行：brew update 保持最新版

最后验证安装：brew -v 得到版本号

参考链接：

https://blog.csdn.net/ljl6158999/article/details/118144440 (macOS升级后安装报错解决办法)

4、npm和nodejs安装

Appium是通过Node.js开发的http服务器，用来创建和控制WebDriver的session，因此需要安装Node.js。npm是Node.js的包管理工具，随同Node.js一起安装。

4.1、（方式一：brew在线安装）【我的nodejs版本是：16.6.0】

安装命令：brew install node 此方法安装的是最新版本

验证安装：node -v  得到版本号

       npm -v  得到版本号

其它在线安装方法：（指定版本安装）

终端执行命令行找到自己合适的node版本 ：brew search node

查询显示最高可以安装 node14 版本

安装命令：brew install node@版本号 (会将npm和nodejs一起安装)

绑定安装的node，命令：brew link --overwrite --force node@版本号

验证安装：node -v 得到版本号

       npm -v 得到版本号

卸载node：

brew uninstall node@版本号 --force

例如：安装的是12.18.1，卸载命令：brew uninstall node@12 --force

4.2、（方式二：离线包安装）

brew在线安装是从官网下载，速度慢且成功率低，可以通过下载离线包安装解决。

nodejs官网下载地址：https://nodejs.org/en/ 点击“Current”区域稳定版。

安装包下载并安装后，同样在终端中输入node -v 、 npm -v 验证

4.3、cnpm国内源安装

NPM安装插件是从NPM官网下载对应的插件包，该网站的服务器在国外，经常会出现下载缓慢或出现异常，这时便需要找到另外的方法提供稳定的下载，这个方法就是CNPM。阿里巴巴的淘宝团队把NPM官网的插件都同步到了在中国的服务器，提供给我们从这个服务器上稳定下载资源。

CNPM同样是NPM的一个插件，要安装的话需要在终端执行以下命令：

sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

验证安装：cnpm -v

4.4、npm安装插件常见报错

在终端通过npm安装插件时，前面加上“sudo”可以减少报错几率。（加上sudo后，命令以系统管理者的身份执行）

如果通过npm安装插件时，出现“npm ERR!”提示，表示安装失败。前缀加上sudo也报错，可以尝试国内源cnpm安装，只需要将命令中的npm换成cnpm。

如果终端安装过程中出现“npm WARN”提示，可以忽略。

5、libimobiledevice安装

libimobiledevice是一个使用原生协议与苹果IOS设备进行通信的库，相当于Android的adb。appium连接iOS设备必需要此依赖库，通过这个库Mac os可轻松获得iOS设备信息。支持iOS10以上系统

安装命令：brew install --HEAD libimobiledevice

卸载：brew uninstall --ignore-dependencies libimobiledevice

常用命令：

1、idevice_id -l    显示当前所连接的设备[udid]，包括 usb、WiFi 连接

2、ideviceinfo       获取设备信息

3、idevicedate       获取设备时间

4、idevicename       获取设备名称

5、idevicescreenshot    截图

6、ideviceinstaller -u [udid] -i [xxx.ipa]  #xxx.ipa：安装文件路径

7、ideviceinstaller -u [udid] -U [bundleId]  #bundleId：应用的包名

检查安装：

报错参考：https://www.cnblogs.com/zhiaijingming/p/11005330.html

6、idevicesinstaller安装

ideviceinstaller是一个管理连接设备的工具，与ios-deploy、Android的adb功能类似。

ideviceinstaller的功能与libimobiledevice差不多，都可以获取iOS设备的udid、安装App、卸载App、获取bundleid等，但ideviceinstaller仅支持iOS9以下系统环境，libimobiledevice支持iOS10以上系统环境。

安装命令：brew install ideviceinstaller

常用命令：

1.ideviceinstaller -l 打印app列表

7、ios-deploy安装

ios-deploy是一个使用命令行安装ios app到连接设备的工具

原理是根据os x命令行调用系统底层函数，获取连接的设备、查询/安装/卸载app

iOS10以上系统使用appium，需要依赖ios-deploy

安装：sudo npm install -g ios-deploy 或 sudo cnpm install -g ios-deploy

安装指定版本的ios-deploy参考：https://www.jianshu.com/p/a100914ec784

ios-deploy常用命令:

1.ios-deploy -c 查看连接的设备（包括通过usb和wifi连接的）

2.ios-deploy -c --no-wifi 查看通过usb连接的设备

3.ios-deploy --id [udid] --bundle [xxx.app] 安装应用到指定设备（其中xxx.app是Xcode编译后的ipa的路径）

4.ios-deploy --id [udid] --uninstall_only --bundle_id [bundleId] 卸载指定设备上的应用（根据包名，也就是bundleId）

5.ios-deploy --id [udid] --list_bundle_id 查看指定设备上安装的所有应用（包括系统应用和第三方）

例如: ios-deploy --id 770dfe115807e7d494b4721b1e4ebd6ecb9424d3 --list_bundle_id

6.ios-deploy --id [udid] --exists --bundle_id [bundleId] 检查指定设备上是否安装了某个应用

例如: ios-deploy --id 0420781d4e43f1f99935513c91e9b816f4dddc24 --exists --bundle_id com.facebook.taozhen

---

注意：Xcode是通过离线包安装的，安装ios-deploy时会报错：

这个是由于Xcode没有设置版本的原因导致的，设置方法：进入Xcode偏好设置-->点击locations-->Comand Line Tools栏选择版本号，

然后重新执行安装命令。如下图：

 

 

---

检查安装：

安装错误解决参考：https://blog.csdn.net/weixin_44643020/article/details/88226097

8、Carthage安装

Carthage是一款iOS项目依赖管理工具，与cocoapods功能相似，可以帮助管理第三方依赖，类似于Java的maven。它会把第三方依赖编译成framework，以framework形式将第三方依赖加入到项目中进行使用和管理。自动化测试用到的WebDriverAgent通过Carthage管理项目依赖。

安装命令：brew install carthage

检查命令：carthage version

未完待续……