Sunday, May 10, 2015

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
Posted by at 3 comments:

Saturday, May 2, 2015

The Appium Training Matrix

Over the next couple of months.  I'm going to create a Appium Training Matrix. The goal will be to provide code examples, videos, and information links to help get you started with Appium.  My first pass will be using Ruby but may expand to other languages later.

Appium Training Matrix:

Also follow me at:
Posted by at 3 comments:
Subscribe to: Posts (Atom)