shabesoglu / appium-setup

Mac environment setup script for Appium.

appium-setup

appium_env.sh is a Mac environment setup script that installs software needed to develop Appium acceptance tests in the language of your choice.

Prerequisites

• Xcode, along with Command Line Tools

If you want to develop Android tests, you also need:

• Android SDK
• Make sure JAVA_HOME is set (add export JAVA_HOME="/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home" to your .bash_profile)
• Make sure ANDROID_HOME is set (add export ANDROID_HOME="/path/to/android/sdk" to your .bash_profile)
• Add /path/to/android/sdk, /path/to/android/sdk/tools, and /path/to/android/sdk/platform-tools to your /etc/paths file (might have to do this with sudo)
• Create an AVD (look into speeding up the emulator using VM acceleration for x86 AVDs) or use a real Android device to run tests on

Execute the script

Example usage:

./appium_env.sh [options]

Running the script with no options installs Appium software only (no language-specific software).

Options:

-h, --help   Prints usage.
-a, --all    Installs all software for all languages.
-f, --force  Ignores certains warnings to force continuation.
--no-source  Does not clone the appium source code.
--haskell    Installs Haskell software.
--ruby       Installs Ruby software.
--java       Installs Java software.
--obj-c      Installs Objective-C software.
--perl       Installs Perl software.
--php        Installs PHP software.
--python     Installs Python software.

What it installs

Appium

• Homebrew
• Node.js
• npm
• grunt
• mocha
• Maven
• Appium command line (from npm)
• Clones the appium Github repo to ~/Documents/appium, if you want to run Appium from source (unless you specify --no-source)

Haskell --haskell

• Haskell Platform
• Cabal
• hs-webdriver

Ruby --ruby

• Ruby 2.0+
• RVM
• selenium-webdriver gem
• appium_lib gem
• rspec gem*
• CI::Reporter gem*

Java --java

• Nothing. Download your chosen webdriver bindings (Selenium HQ Java, java-client)

Objective-C --obj-c

• xctool
• Download the framework from GitHub

Perl --perl

• Nothing. Install the module by following the instructions from Selenium-Remote-Driver

PHP --php

• PHP 5.3
• Pear
• Composer
• Xdebug*
• PHPUnit*
• Download your chosen webdriver bindings (php-webdriver, phpunit-selenium, php-client, etc.)

Python --python

• Python 2.7
• pip
• Download your chosen webdriver bindings (selenium, Appium-Python-Client)

* Substitute this with the test framework of your choice.

After the script runs

• Install Appium.app if you would like and have not done so already. It has a nice Inspector functionality that allows you to record actions and view elements.
• Run git pull and then ./reset.sh --dev on ~/Documents/appium.