Running Appium on Mac OS X 
=======

Appium on OS X supports iOS and Android testing.

<a name="ios"></a>System setup (iOS)
--------

* Appium requires Mac OS X 10.7, but 10.8 is recommended.
* Make sure you have XCode and the iOS SDK(s) installed.
* You might also want to install additional versions of the iOS SDKs if you
  want to test on older or multiple versions.
* You need to authorize use of the iOS Simulator. If you are running Appium
  from NPM, you'll do this by running `sudo authorize_ios` (`authorize_ios` is
  a binary made available by the Appium npm package). If you're running Appium
  from source, simply run `sudo grunt authorize` to do the same thing.

<a name="android"></a>System setup (Android)
--------

* Make sure you have the Android SDK installed
* Make sure you have Android SDK API &gt;= 17 installed. To do this, run the
  android SDK manager and select the API in the extra packages you can install.
* Make sure you have ant installed. Ant is used to build the Appium bootstrap
  jar as well as the test applications.
* Make sure you have exported `$ANDROID_HOME`, containing your android sdk
  path. If you unzipped the Android SDK to `/usr/local/adt/`, for example, you
  should add this to your shell startup:

        export ANDROID_HOME="/usr/local/adt/sdk"

* Make sure you have an AVD set to a recent Android version (one that can run
  UIAutomator. Just choose the latest Android OS). You can create an AVD by
  using the android SDK tools. Remember the name you give the AVD, so that you
  can launch an emulator with it and run tests against it.
* Make sure that `hw.battery=yes` in your AVD's `config.ini`.
* There exists a hardware accelerated emulator for android, it has its own
  limitations. For more information you can check out this
  [page](https://github.com/appium/appium/blob/master/docs/android-hax-emulator.md).
