环境准备

为了避免走弯路，我们先要确保三点：

• Android SDK API >= 17 (Additional features require 18)

• 环境变量 ANDROID_HOME 并确保 $ANDROID_HOME/platform-tools 和 $ANDROID_HOME/tools 包含在 PATH 里。比如:

  export ANDROID_HOME="/Applications/adt-bundle-mac-x86_64-20130729/sdk"
  export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools
  

• 如果用实体机测试，请确保系统是 4.1 以上的。

否则的话，你会遇到诸如此类的问题：

2.x 的真机

info: "/Applications/adt-bundle-mac-x86_64-20130729/sdk/platform-tools/adb" -s S5830f63efdb6 shell uiautomator runtest AppiumBootstrap.jar -c io.appium.android.bootstrap.Bootstrap
info: [ADB STDOUT] uiautomator: permission denied

4.0.x 的真机

info: "/Applications/adt-bundle-mac-x86_64-20130729/sdk/platform-tools/adb" -s HT1B4V803001 shell uiautomator runtest AppiumBootstrap.jar -c io.appium.android.bootstrap.Bootstrap
info: [ADB STDOUT] /system/bin/sh: uiautomator: not found

如果使用的是 Appium.dmg 安装的 Appium，那要设置 custom android sdk， 如图

这样 Appium 启动的时候可以使用 adb android 等命令。

这三点都做到的情况下，我们要看下 devices 的情况，因为运行 appium 测试脚本前要确保，devices 连接上了。所以要做的是：启动模拟器或者连上手机

• 模拟器

  Make sure that hw.battery=yes in your AVD's config.ini.
  比如我的 AVD 叫 appium， 所以我就要去编辑 $HOME/.android/avd/appium.avd/config.ini 文件确保 hw.battery=yes

• 真机

  Mac 上只要连接上 USB 就可以了， 无需安装驱动。不过我遇到了一个问题，海信的手机没法识别出来。
  这需要在 $HOME/.android/adb_usb.ini 里添加 vender id。

  ➜  ~  cat .android/adb_usb.ini
  # ANDROID 3RD PARTY USB VENDOR ID LIST -- DO NOT EDIT.
  # USE 'android update adb' TO GENERATE.
  # 1 USB VENDOR ID PER LINE.
  0x109b # 海信手机的 VENDOR ID + 0x
  

  如果你发现你手机无法识别，去 http://developer.android.com/tools/device.html 寻找 ID。

然后我们运行 adb devices -l,

➜  ~  adb devices -l
List of devices attached
emulator-5554          device product:sdk model:sdk device:generic
e912s                  device usb:24100000

P.S Appium 支不支持多个 device 还没有定论。可以参考 https://groups.google.com/forum/#! topic/appium-discuss/xKCt4HrerrU

我们关掉模拟器，因为模拟器实在太慢了。(在模拟器上运行过 sample code， 都是能正常运行的。)

写个脚本玩玩

其实 sample code 里面的代码已经非常丰富了。就照搬一个吧。

# -*- coding: utf-8 -*-
import os
import glob
import unittest
from selenium import webdriver


class TestMyGame(unittest.TestCase):

    def setUp(self):
        app = os.path.abspath(glob.glob(os.path.dirname(__file__)
                                        + './*.apk')[0])
        desired_caps = {
            'device': 'appium',
            'app': app,
            'app-package': 'com.example.android.contactmanager',
            'app-activity': '.ContactManager'
        }

        self.driver = webdriver.Remote('http://localhost:4723/wd/hub',
                                       desired_caps)

    def test(self):
        driver = self.driver
        el = driver.find_element_by_name("Add Contact")
        el.click()
        textfields = driver.find_elements_by_tag_name("textfield")
        textfields[0].send_keys("My Name")
        textfields[2].send_keys("someone@somewhere.com")
        driver.find_element_by_name("Save").click()

    def tearDown(self):
        self.driver.quit()

if __name__ == '__main__':
    unittest.main()

ContactManager 是 android sample 里面的代码。 大家在安装 adt tool 的时候，可以获取。
我把 build 出来的 apk 和下面这个脚本放在一个目录下，然后运行。

在使用模拟器的时候，除了慢，工作的非常好。但是在海信的真机上就悲剧了。 因为在聚焦输入框的时候，弹出了搜狐输入法，干扰了 send_key 方法。github 上有 issue 记录，可惜没有好的解决方法。（https://github.com/appium/appium/issues/173）

至此，整个安卓的流程都跑过来了。总的来说， Appium 目前还不是很成熟。不过应该是未来的方向。学起来总归是好的！

以上所有步骤，都在 mac 10.9 xcode 5.0.1 上运行通过。