Mac 上安装 Appium 详解

一、Appium 配置 [æ pi' ʌm]

• Mac 平台能真正发挥 Appium 的功能，因为 Mac平台既能 测试Android App 又能测试 iOS App。

• Mac 中安装 Appium 需要安装 jdk，git ，ruby，python，brew，node，npm，wd 等程序。

Mac OS X 中安装 jdk 8

MAC中配置JDK详解链接

• 下载 jdk程序包。

• jdk 程序下载URL地址：
  http://www.oracle.com/technetwork/java/javase/downloads/index.html
  http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

• 下载文件： jdk-8u141-macosx-x64.dmg // (20170719)

• 双击下载的 .dmg 文件，进行 jdk 的安装

• 打开<终端> 输入 java -version

~ mac$ java -version
java version "1.8.0_141"
Java(TM) SE Runtime Environment (build 1.8.0_141-b15)
Java HotSpot(TM) 64-Bit Server VM (build 25.141-b15, mixed mode)

• jdk的安装目录为：/Library/Java/JavaVirtualMachines，里面有所有安装的JDK

Mac 中其它程序版本:

• git程序
  命令行中输入：git --version
  git version 2.3.2 (Apple Git-55)

~ admin$ git --version
git version 2.11.0 (Apple Git-81)

• ruby 程序 MAC_Ruby 安装详解链接20170719
  命令行中输入：ruby --version

~ mac$ ruby --version
ruby 2.4.0p0 (2016-12-24 revision 57164) [x86_64-darwin16]

• python程序
  命令行中输入：python -V
  Python 2.7.10

~ admin$ python -V
Python 2.7.10

• 安装 node.js (如果没有安装brew,按照下面的步骤安装)
  Appium 依赖 Node.js环境，因此需要先安装node 环境。
  终端执行命令：

• $ brew install node

• 具体如下:

~ mac$ brew install node
Updating Homebrew...
==> Auto-updated Homebrew!
Updated 1 tap (homebrew/core).
==> Updated Formulae
cromwell            jfrog-cli-go        paket               psqlodbc

==> Installing dependencies for node: icu4c
==> Installing node dependency: icu4c
==> Downloading https://homebrew.bintray.com/bottles/icu4c-58.2.sierra.bottle.ta
######################################################################## 100.0%
==> Pouring icu4c-58.2.sierra.bottle.tar.gz
==> Using the sandbox
==> Caveats
This formula is keg-only, which means it was not symlinked into /usr/local,
because macOS provides libicucore.dylib (but nothing else).

If you need to have this software first in your PATH run:
  echo 'export PATH="/usr/local/opt/icu4c/bin:$PATH"' >> ~/.bash_profile
  echo 'export PATH="/usr/local/opt/icu4c/sbin:$PATH"' >> ~/.bash_profile

For compilers to find this software you may need to set:
    LDFLAGS:  -L/usr/local/opt/icu4c/lib
    CPPFLAGS: -I/usr/local/opt/icu4c/include
For pkg-config to find this software you may need to set:
    PKG_CONFIG_PATH: /usr/local/opt/icu4c/lib/pkgconfig

==> Summary
🍺  /usr/local/Cellar/icu4c/58.2: 242 files, 65MB
==> Installing node
==> Downloading https://homebrew.bintray.com/bottles/node-8.1.4.sierra.bottle.ta
######################################################################## 100.0%
==> Pouring node-8.1.4.sierra.bottle.tar.gz
==> Caveats
Bash completion has been installed to:
  /usr/local/etc/bash_completion.d
==> Summary
🍺  /usr/local/Cellar/node/8.1.4: 3,782 files, 44.5MB

• 或者升级

~ admin$ brew install node
Error: node 7.10.0 is already installed
To upgrade to 8.2.0_1, run `brew upgrade node`
ZhaoMengXin:~ admin$ brew upgrade node
==> Upgrading 1 outdated package, with result:
node 8.2.0_1
==> Upgrading node 
==> Downloading https://homebrew.bintray.com/bottles/node-8.2.0_1.sierra.bottle.
######################################################################## 100.0%
==> Pouring node-8.2.0_1.sierra.bottle.tar.gz
==> Using the sandbox
==> Caveats
Bash completion has been installed to:
  /usr/local/etc/bash_completion.d
==> Summary
🍺  /usr/local/Cellar/node/8.2.0_1: 4,151 files, 45.9MB

• 安装完成后，可以执行 node -v 查看node版本。

~ mac$ node -v
v8.1.4

brew 程序安装

brew 全称 Homebrew 是 Mac OSX 上的软件包管理工具
Homebrew 安装和卸载工具只用一行命令就能完成
官方地址: http://brew.sh/index.html

~ mac$ brew -v
Homebrew 1.2.4
Homebrew/homebrew-core (git revision 37792; last commit 2017-07-18)

当没有安装 brew 程序时，在终端执行下列命令行，安装brew程序：

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

具体安装步骤如下：

~ mac$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
==> This script will install:
/usr/local/bin/brew
/usr/local/share/doc/homebrew
/usr/local/share/man/man1/brew.1
/usr/local/share/zsh/site-functions/_brew
/usr/local/etc/bash_completion.d/brew
/usr/local/Homebrew

// 按回车键继续或任何其他中止键
Press RETURN to continue or any other key to abort 

==> /usr/bin/sudo /bin/mkdir -p /Users/mac/Library/Caches/Homebrew
Password:  //输入电脑密码
==> /usr/bin/sudo /bin/chmod g+rwx /Users/mac/Library/Caches/Homebrew
==> /usr/bin/sudo /usr/sbin/chown mac /Users/mac/Library/Caches/Homebrew
==> /usr/bin/sudo /bin/mkdir -p /Library/Caches/Homebrew
==> /usr/bin/sudo /bin/chmod g+rwx /Library/Caches/Homebrew
==> /usr/bin/sudo /usr/sbin/chown mac /Library/Caches/Homebrew
==> Downloading and installing Homebrew...
remote: Counting objects: 1201, done.
remote: Compressing objects: 100% (660/660), done.
remote: Total 1201 (delta 912), reused 704 (delta 507), pack-reused 0
Receiving objects: 100% (1201/1201), 602.94 KiB | 197.00 KiB/s, done.
Resolving deltas: 100% (912/912), completed with 359 local objects.
From https://github.com/Homebrew/brew
 + b38c52f930...f2c2964cf7 master     -> origin/master  (forced update)
 * [new tag]               1.1.12     -> 1.1.12
 * [new tag]               1.1.13     -> 1.1.13
 * [new tag]               1.2.0      -> 1.2.0
 * [new tag]               1.2.1      -> 1.2.1
 * [new tag]               1.2.2      -> 1.2.2
 * [new tag]               1.2.3      -> 1.2.3
 * [new tag]               1.2.4      -> 1.2.4
HEAD is now at f2c2964cf7 Merge pull request #2912 from jonchang/python-shadowing-docs

Updated 2 taps (homebrew/core, homebrew/versions).
==> Cleaning up /Library/Caches/Homebrew...
==> Migrating /Library/Caches/Homebrew to /Users/mac/Library/Caches/Homebrew...
==> Deleting /Library/Caches/Homebrew...
==> New Formulae
adr-tools                                jenkins-lts
afuse                                    jhipster
alexjs                                   jing-trang
allure                                   jose
...
...
...
libmatroska                              zookeeper
libmaxminddb                             zsh
libmemcached                             zsh-autosuggestions
libmicrohttpd                            zsh-completions
libmikmod                                zstd
libming                                  zurl
==> Renamed Formulae
bazel02 -> bazel@0.2
bigdata -> blazegraph
bison27 -> bison@2.7
...
...
...
varnish4 -> varnish@4
vim74 -> vim@7.4
zeromq32 -> zeromq@3.2
zeromq40 -> zeromq@4.0
==> Deleted Formulae
autotrace                                homebrew/versions/redis1310
blucat                                   libgc
devhelp                                  libtess2
dvtm                                     multirust
elasticsearch@1.7                        node@0.10
elasticsearch@2.3                        node@0.12
fb-adb                                   scsh
gnupg2                                   snescom
homebrew/versions/gst-ffmpeg010          webkitgtk
homebrew/versions/imagemagick-ruby186    xplanetfx
homebrew/versions/mono3                  xstow
homebrew/versions/play14
==> Migrating cloog018 to cloog
==> Unlinking cloog018
==> Moving cloog018 children
==> Linking cloog
==> Installation successful!

==> Homebrew has enabled anonymous aggregate user behaviour analytics.
Read the analytics documentation (and how to opt-out) here:
  http://docs.brew.sh/Analytics.html

==> Next steps:
- Run `brew help` to get started
- Further documentation: 
    http://docs.brew.sh

Mac:~ mac$ brew -v
Homebrew 1.2.4
Homebrew/homebrew-core (git revision 37792; last commit 2017-07-18)

使用 brew 安装软件
比如安装git
brew install git

比如安装wget
brew install wget

使用brew卸载软件
brew uninstall wget

使用brew查询软件
brew search /wge/
/wge/是个正则表达式， 需要包含在其中

其他brew命令
brew list 列出已安装的软件
brew update 更新brew
brew home 用浏览器打开brew的官方网站
brew info 显示软件信息
brew deps 显示包依赖

Mac上安装Node和npm 链接: http://www.jianshu.com/p/20ea93641bda

安装npm

npm是什么？
�NPM的全称是Node Package Manager ，是一个NodeJS包管理和分发工具，已经成为了非官方的发布Node模块（包）的 标准。

• 如何安装
• 如果你安装了Homebrew
• 直接使用命令：$ brew install node
• 执行完上面的命令，你就安装好了nodejs和npm

查看npm程序版本 命令行中输入：npm -v

~ mac$ npm -v
5.0.3

下载Android SDK，测试Android App需要。

下载地址：http://www.androiddevtools.cn/
选择：[android-sdk_r24.4.macosx.zip]（写本文时的最新版，使用迅雷会比较快）如图：

解压缩到任意位置，比如 /usr/local/android-sdk-macosx下。
运行/usr/local/android-sdk-macosx/tools/android，即可启动Android SDK Manager。

不过我躺枪了 天朝有墙！！！

直接点击close 接着等待。。。

已经吐血了！！！

google的很多网站在国内无法访问，苦逼了我们！

打开 SDK Manager 的图形界面

Android SDK Manager -> Preferences...

http proxy server 这里填写： mirrors.neusoft.edu.cn （感谢东软搭建国内的镜像服务器，为广大程序员造福无数）
端口填写80，然后把Force https:// 前的勾勾上

• Mac顶部菜单Tools->Manage Add-on Site

把下面这堆网址：

http://mirrors.neusoft.edu.cn/android/repository/addon-6.xml
http://mirrors.neusoft.edu.cn/android/repository/addon.xml
http://mirrors.neusoft.edu.cn/android/repository/extras/intel/addon.xml
http://mirrors.neusoft.edu.cn/android/repository/sys-img/android-tv/sys-img.xml
http://mirrors.neusoft.edu.cn/android/repository/sys-img/android-wear/sys-img.xml
http://mirrors.neusoft.edu.cn/android/repository/sys-img/android/sys-img.xml
http://mirrors.neusoft.edu.cn/android/repository/sys-img/google_apis/sys-img.xml
http://mirrors.neusoft.edu.cn/android/repository/sys-img/x86/addon-x86.xml
http://mirrors.neusoft.edu.cn/android/repository/addons_list-2.xml
http://mirrors.neusoft.edu.cn/android/repository/repository-10.xml

全手动New加进去，然后就可以下载

如图:

下载和更新 Android SDK Tolls 和 Android SDK Platform-tools 。如下图的前3个就可以了。。。

保持默认的选项即可，点击Install 8 packages…。进入到下图：

Accept License。然后Install就可以了。这个过程根据网速不同，可能需要10-20分钟，耐心等待。

设置Android环境变量：

• 方法 1：点击桌面空白位置然后使用快捷键shift+cmd+G
  输入~/.bash_profile，找到.bash_profile文件，打开后在该文件中添加：

export JAVA_HOME=$(/usr/libexec/java_home)
export ANDROID_HOME=/usr/local/android-sdk-macosx

终端执行 source ~/.bash_profile 使环境变量生效。

• 方法 2：终端输入：vi .bash_profile
  按 i 键进入bash_profile文件编辑模式，完成之后esc键退出编辑，:wq结束。 同样执行 source ~/.bash_profile 使环境变量生效。
  至此，为了安装Appium所需要的Mac平台已经配置完毕了。接下来开始安装Appium。

Appium安装

Mac平台环境安装完毕之后，就可以开始安装Appium了。
Mac下搭建appium环境有两种方法：

• 直接下载 appium.dmg 运行即可
  Appium官网下载链接：https://bitbucket.org/appium/appium.app/downloads/ 直接安装即可。
• appium doctor用来appium的是否成功安装，即点击下图按钮：

• 终端输出信息像下面这样全是对号，则表示环境安装成功了。

Last login: Tue Nov  1 14:55:59 on ttys002
wldeMacBook-Pro:~ wl$ '/Applications/Appium.app/Contents/Resources/node/bin/node' '/Applications/Appium.app/Contents/Resources/node_modules/appium-doctor/appium-doctor.js'
info AppiumDoctor ### Diagnostic starting ###
info AppiumDoctor  ✔ Xcode is installed at: /Applications/Xcode7.3.1.app/Contents/Developer
info AppiumDoctor  ✔ Xcode Command Line Tools are installed.
info AppiumDoctor  ✔ DevToolsSecurity is enabled.
info AppiumDoctor  ✔ The Authorization DB is set up properly.
info AppiumDoctor  ✔ The Node.js binary was found at: /usr/local/bin/node
info AppiumDoctor  ✔ HOME is set to: /Users/wl
info AppiumDoctor  ✔ ANDROID_HOME is set to: /usr/local/android-sdk-macosx
info AppiumDoctor  ✔ JAVA_HOME is set to: /Library/Java/JavaVirtualMachines/jdk1.8.0_91.jdk/Contents/Home
info AppiumDoctor  ✔ adb exists at: /usr/local/android-sdk-macosx/platform-tools/adb
info AppiumDoctor  ✔ android exists at: /usr/local/android-sdk-macosx/tools/android
info AppiumDoctor  ✔ emulator exists at: /usr/local/android-sdk-macosx/tools/emulator
info AppiumDoctor ### Diagnostic completed, no fix needed. ###
info AppiumDoctor 
info AppiumDoctor Everything looks good, bye!
info AppiumDoctor

不过想象是美好的，但是结果是残酷的：

这个问题存在的原因就是appium 不兼容最新的mac10.12版本。
由于10.12是最新mac版本，appium1.5.3并未提供支持，所以：

在终端输入

$ grep -rl "Could not detect Mac OS X Version from sw_vers output:" /Applications/Appium.app/ 

找出包含的文件并修改版本号。
这个时候你会看到这个结果 :

• 得到了四个js文件的地址，使用vim 命令一一打开这几个文件 例：

~ mac$ vim /Applications/Appium.app//Contents/Resources/node_modules/appium/node_modules/appium-support/build/lib/system.js

打开第一个后看到这个文件，找到这行:

看到的可能没有那么多新的版本，那这时候点击i进入编辑模式将你们的系统版本加进去，编辑完后点击Esc，输入
:wq 保存修改 修改为：

打开第二个地址看到这个地方 :

修改为：

这个时候还有两个文件，打开后你会发现差不多，一样的方法打开完成修改后我们再来诊断一下

• 但是也有可能会遇到 X Xcode Command Line Tools are not installed.这个情况，那不用担心，小问题:

• 这是因为在从App Store上下载Xcode后，默认是不会安装Command Line Tools的，Command Line Tools是在Xcode中的一款工具，可以在命令行中运行C程序。
• 解决办法：
  打开命令行终端，输入以下命令：xcode-select --install
  回车，出来以下安装画面

• 安卓的SDK 安装出错：

WARN AppiumDoctor  ✖ ANDROID_HOME is set to '/usr/local/android-sdk-macosx' but this is NOT a valid path!
WARN AppiumDoctor  ✖ adb could NOT be found at '/usr/local/android-sdk-macosx/platform-tools/adb'!
WARN AppiumDoctor  ✖ android could NOT be found at '/usr/local/android-sdk-macosx/tools/android'!
WARN AppiumDoctor  ✖ emulator could NOT be found at '/usr/local/android-sdk-macosx/tools/emulator'!
WARN AppiumDoctor - Manually configure ANDROID_HOME.
WARN AppiumDoctor - Manually install adb and add it to PATH.
WARN AppiumDoctor - Manually install android and add it to PATH.
WARN AppiumDoctor - Manually install emulator and add it to PATH.

• 终端输入命令：
  vi .bash_profile
• 完成后点i进入编辑模式，加入

export JAVA_HOME=$(你的Java安装到的地址)
例如 export JAVA_HOME=$(/usr/Library/java)

export ANDROID_HOME=你刚才下载的SDK在的地址
例如 export ANDROID_HOME=/usr/local/android-sdk-macosx

点击Esc退出，输入:wq保存，还有比较重要的一步 ！！！
输入: $ source ~/.bash_profile
让环境变量生效，切记

• 最终：

备注：
也有node报错的：

• The Node.js binary was not found at: /usr/local/bin/node**
  尽管有些说安装了appium会自动安装nodejs,但事实好像并不是这样，一样无脑的解决办法，去node官网，地址：http://nodejs.cn/download/，下载Mac版，解压，安装，安装完成继续诊断。

~ admin$ appium -v
1.6.5

• 也有使用 使用npm安装(这里不做讲解，下面有链接可以参考一下学习)
  下载dmg包安装的方法，很简单，和安装所有的dmg包一样。不多介绍了。下面主要介绍下通过npm安装的方法。
  官网上提供的步骤是下面这样的：

> brew install node      # get node.js
> npm install -g appium  # get appium
> npm install wd         # get appium client
> appium &               # start appium
> node your-appium-test.js

先升级homebrew：brew update，以便能够安装最新版的node。我第一遍安装的时候，就是因为没有升级brew，所以通过brew install node安装的node版本比较低，导致用npm安装appium提示“’appnium’ is not in the npm registry.”

参考的文章: https://testerhome.com/topics/1225