mac下Appium环境配置

一、Appium环境搭建

1、xcode（需要OS X版本支持）：

下载对应版本的xcode（支持对应手机系统），解压，拖入应用程序。

xcode下载地址：https://developer.apple.com/download/more/

2、安装appium：

安装node、brew、nmp、carthage等：http://www.jianshu.com/p/efa9ac4900a6

1）如果有旧版本的appium，需要先卸载旧版本的appium：npm uninstall -g appium

2）下载appium1.6.5正式版：https://github.com/appium/appium/releases/tag/v1.6.5，终端进入文件目录，命令行安装：npm install。

      验证安装成功：终端输入“appium -v”，出现版本号表示安装成功。

　　此处有坑：appium-desktop 1.6.4及以下不支持xcode9.0.1，（请注意自己的xcode版本和appium版本，要不然会报错）

3）与系统进行关联：npm link

4）安装appium桌面程序：https://github.com/appium/appium-desktop/releases/tag/v1.2.0，下载zip包，解压，拖入应用程序。

5）Appium自带的WebDriverAgent存在bug，改使用FaceBook的WebDriverAgent（WebDriverAgent下载：https://github.com/facebook/WebDriverAgent/）：

从git上下载WebDriverAgent，进入/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent 目录，命令行运行：./Scripts/bootstrap.sh，下载依赖，然后将该文件替换appium应用中的WebDriverAgent（目录：/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent ）

使用xcode打开WebDriverAgent程序，在真机上安装WebDriverAgent程序，手机上出现WebDriverAgent应用表示安装成功。（在通用-> 描述文件文件中信任xcode使用的开发者证书）

参考：https://testerhome.com/topics/7220

　　　http://www.7forz.com/2973/

3、检测appium环境：

终端输入：appium-doctor

4、启动appium桌面程序：

AppiumDesktop使用：https://www.jianshu.com/p/bf1ca3d4ac76

启动Appium。在运行自动化测试脚本前一定要先运行Appium，启动测试应用。

1）通过下面的两种方式启动appium服务器。(appium启动会先启动webdriveragent，启动之后不要将webdriverAgent关闭，否则再次启动appium会报错)

方式1、通过命令行安装的appium可以通过终端启动，终端输入：appium，看到终端打印出下面日志，表示服务器启动成功。

 

方式2、已经安装了appium桌面程序可以通过启动桌面程序来启动appium服务器。打开程序看到如下页面：

 

 

直接点击Start Server即可启动appium服务器，跟终端命令行启动打印出的日志一样，如下所示：

 

 

上图三个红色框分别表示：①查看应用元素（inspector）②保存日志文件③停止appium服务器。

启动了appium服务器之后。可以直接运行自动化。

）配置一些Desired Capabilities信息：

 

 

默认会以127.0.0.1ip和4723端口启动一个session，如果要启动多个session，可以通过修改端口号的方式：点击Custom Server，服务器ip输入127.0.0.1，端口输入一个目前未在使用的端口号就可以了。

一般需要填写的参数有platformName（平台）、platformVersion（平台版本）、udid（设备的udid，填错不能启动应用）、deviceName（设备名称）、bundleid（应用的bundleid）、automationName（必须填写XCUITest，不写默认是UIAutomation的方式，该方式不支持IOS10）。

要连接iOS真机，必须打开真机的开发者模式。

然后选中要启动的已经配置好的信息，点击Start Session。看到下面的画面表示启动成功，可以查看元素的accessibility_id、xpath、value等和坐标。支持录制脚本。

 

二、安装及运行过程中遇到的坑

坑1、

A new session could not be created. Details: Appium's IosDriver does not support xcode version 8.3.3.

Apple has deprecated UIAutomation. Use the "XCUITest" automationName capability instead.

解决方案：

在--capability添加automationName=XCUITest参数

 

坑2、

AssertionError: Message: An unknown server-side error occurred while processing the command.

Original error: Unknown device or simulator UDID: '***'

解决方案：

Appium使用idevice_id（libimobiledevice的一部分）来确定设备的可用性

brew install libimobiledevice --HEAD

 

坑3、

AssertionError: Message: An unknown server-side error occurred while processing the command. Original error: 

Could not initialize ios-deploy make sure it is installed (npm install -g ios-deploy) and works on your system

解决方案：

安装ios-deploy

npm install -g ios-deploy

 

坑5：

appium-desktop 1.6.4及以下不支持xcode9.0.1，需要升级appium

 

坑6：

webdriverAgent安装失败

解决方案：

重新编译webdriverAgent，参考地址

https://www.cnblogs.com/baconLiu/p/6861431.html

http://www.cnblogs.com/meitian/p/7359787.html

 

cd /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent

xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=3825bba08e5c10c499ddaf0276bac01983ab7119' test

 

其他人发现的坑：http://blog.csdn.net/Temanm/article/details/51862600