Appium Step by Step Installation: Installing Appium.dmg and Ruby on Mac (Simple Introduction - Step by Step Tutorial)

After much pain. I hope this step by step tutorial for installing Appium and Ruby on a Mac makes it much easier for you.

I will focus on what i've found to be the easiest way to install Appium and that is using only the Appium.dmg.

Another way is you can install the command line version of Appium or do what I did initially and install both the dmg and command line version. For those interested in the command line version visit Appium.io and reference the easy setup process at the bottom.

Accompanying Youtube Video: Appium and Ruby Installation

1. Install Java JDK

Download Java JDK

Install from downloads

Next add path to profile

Open terminal

For Mac OSX 10.5 or later.

At the command prompt in terminal "$".  Don't type $

Edit your .bash_profile with "." before to update your environment to point correctly to java

• $ cd
• $ open -a TextEdit .bash_profile

If the file doesn't exist you will get the error:

• The file /Users/???/.bash_profile does not exist.

Then

• $ touch .bash_profile
• $ open -a TextEdit .bash_profile

Insert into .bash_profile and save

   export JAVA_HOME=$(/usr/libexec/java_home)

Restart the terminal to include the new configurations.  In terminal type:

• $ source .bash_profile
• or just quit and reopen terminal

To test in terminal

• $ java -version

For Older Mac OSX

Same as above but hardcode path and replace ?.?.? with your version

   export JAVA_HOME=/System/Library/Java/JavaVirtualMachines/?.?.?.jdk/Contents/Home

2. Install Android Studio/SDK

Download Android Studio for Mac

Install all SDK tools and emulators

• Select "Configure"
• Select "SDK Manager"
• Install all available packages

Install All Packages

Edit your .bash_profile with "." before to update your environment to point correctly to Android

• $ cd
• $ pwd
• the result will be /Users/???,  Copy ??? for ANDROID_HOME below
• $ open -a TextEdit .bash_profile

Insert into .bash_profile and save

   export ANDROID_HOME=/Users/???/Library/Android/sdk
   export ANDROID_SDK=$ANDROID_HOME
   PATH=$PATH:$ANDROID_HOME/build-tools
   PATH=$PATH:$ANDROID_HOME/tools
   PATH=$PATH:$ANDROID_HOME/platform-tools
   export PATH

Restart the terminal to include the new configurations.  In terminal type:

• $ source .bash_profile
• or just quit and reopen terminal
• $ echo $ANDROID_HOME

3. Install Xcode

• Open App Store
• Search for Xcode
• Click Install (This can take a while)

Install Xcode

Additional versions of Xcode

Install Simulators

• Xcode -> Preferences -> Downloads
• Select all the Simulators
• Click down arrows to download

It can take a while to download,  make sure you have time to complete the whole download.

4. Install Appium.dmg (Currently using 1.3.6) I had issues with 1.3.7

Download appium 1.3.6 dmg

Open and Authorize

Update General Settings

• UnCheck - "Check for updates"

Run Appium Doctor

Select Appium Doctor

• Fix it "Y"
• Yes to install "Command Line Tools Installation"
• Fix it "Y"

5. Install Homebrew

Homebrew helps install the things you need for your Mac and it makes the following installations significantly easier.

Copy "ruby -e ..."

• copy "ruby -e .." from homebrew.sh page
• open terminal and paste
• $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
• $ brew doctor
• $ brew update

6. Install ideviceinstaller (Needed for IOS applications)

Open terminal

• $ brew install --HEAD ideviceinstaller

7. Install ios-webkit-debug-proxy (Needed for IOS mobile web)

Open terminal

• $ brew install ios-webkit-debug-proxy

8. Install Ruby with rbenv (Version 2.2.1 is Stable)

Open terminal

• $ brew install rbenv ruby-build
• $ rbenv install 2.2.1
• $ rbenv local 2.2.1
• $ rbenv global 2.2.1
• $ rbenv rehash

Edit your .bash_profile with "." before to update your environment to point correctly to java

• $ cd
• $ open -a TextEdit .bash_profile

Insert into .bash_profile and save

   # Initialize rbenv

   if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi

Restart the terminal to include the new configurations.  In terminal type:

• $ source .bash_profile
• or just quit and reopen terminal

Open terminal

• $ ruby --version

9. Install Bundler

Bundler is a tool that helps manage your Ruby gems dependencies.  Bundler website.

Opern terminal

• $ gem install bundler