本文主要讲述在Mac机器上如何安装和配置Appium移动自动化工具,及其遇到的一些问题和解决办法。
1. 基本环境
这是在安装Appium之前的基本软硬件环境,
Mac Mini (OS X Yosemite 10.10.5)
iPod(iOS 8.3)
Xiaomi 4c (Android 5.1.1)
接下来需要在上述环境中安装和配置如下工具,
JDK 7 (1.7.75)
Android SDK (24.4.1)
Xcode (7.2.1)+ iOS simulator (8.3)
Homebrew (0.9.5)
Node (5.7.1)
Appium for Mac (1.4.13)
2. 安装JDK7
到Java官方网站下载JDK7,安装后配置如下环境变量,
export JAVA_HOME=/jdk_installation_path/ export PATH=$JAVA_HOME/bin:$PATH
3. 安装Android SDK Tools
国内可以到这里(Android Studio 中文组)下载最新的Android SDK Tools Package,安装后配置如下环境变量,
export ANDROID_HOME=/jdk_installation_path/ export PATH=$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:$PATH
工具包安装后,其实里面还没有Platform Tools,这需要启动Android SDK Manager,通过SDK Manager下载,具体见下图,
在下载前,推荐参考此文章配置下载源为国内的镜像地址,以提高下载速度。下图配置下载源到东软,
4. 安装Xcode
直接登录App Store,安装最新版本的Xcode,然后simulator的不同版本可以在Xcode Preferences中的Downloads页中选择下载。
5. 安装Homebrew
Homebrew是Mac OS上的包管理工具,可以安装一些底层工具包。运行下面的命令即可在Mac上安装这个包管理工具brew,
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
更多详细安装信息可以参考homebrew网站。
安装完毕之后,运行如下两个命令安装上相应的工具,
brew install ideviceinstaller brew install ios-webkit-debug-proxy
6. 安装Node
登录到官方网站,下载最新的Node.js并安装。
7. 安装Appium
Appium官方下载地址:https://bitbucket.org/appium/appium.app/downloads/
选择最新Mac安装包appium-1.4.13.dmg并下载,双击后安装到应用程序中。
8. 环境检查
上述所有工具安装配置完毕之后,运行Appium GUI,点击上面的环境检查按钮,如果环境配置成功的话,则会出现如下信息,
Running iOS Checks Xcode is installed at /Applications/Xcode.app/Contents/Developer Xcode Command Line Tools are installed. DevToolsSecurity is enabled. The Authorization DB is set up properly. Node binary found at /usr/local/bin/node iOS Checks were successful. Running Android Checks ANDROID_HOME is set to "/Users/test/ws/local/android-sdk" JAVA_HOME is set to "/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/." ADB exists at /Users/test/ws/local/android-sdk/platform-tools/adb Android exists at /Users/test/ws/local/android-sdk/tools/android Emulator exists at /Users/test/ws/local/android-sdk/tools/emulator Android Checks were successful. All Checks were successful
8. 移动设备配置
a) 安卓设备
在安卓设备上,需要开启开发者选项,并且连接USB后启用调试模式。
配置完毕后,通过USB线连接上设备,在机器上运行adb devices命令就可以查询到当前连接设备的GUID,
b) iOS设备
打开“设置” -》“开发者”选项 -》启用“Enable UI Automation”选项
打开“设置” -》“Safari”选项 -》“高级”选项 -》“高级”选项-》启用“JavaScript”和“Web检查器”两个选项。
配置完毕后,可以通过xcode或者instruments查看到当前连接的iOS设备。
9. 遇到的一些问题和解决办法
问题1 - Appium连接iOS 设备启动应用时,Appium提示 “Couldn't not initialize ideviceinstaller;make sure it is installed and works on your system”。
这是由于当前环境缺少ideviceinstaller这个工具,运行命令brew install ideviceinstaller安装后,问题解决。
问题2 - Appium连接iOS 设备报错,错误消息为Could not connect to WebKitRemoteDebugger server
这是由于当前环境缺少ios-webkit-debug-proxy这个工具,运行命令brew install ios-webkit-debug-proxy安装后,问题解决。
https://testerhome.com/topics/3129
https://testerhome.com/topics/3206
更多参考信息
appium tutorial - Setting up Appium,这是官方安装文档。
appium tutorial中文版 -http://appium.io/slate/cn/master/?ruby#about-appium
test home的中文文档 1 -https://testerhome.com/topics/3144,该文档不仅仅是一个API文档,也有安装配置相关部分。
appium的中文文档 2 - https://testerhome.com/wiki/appiumdoccn