Set Up Appium on MacOS for Testing Android Devices

Applies to TestComplete 15.63, last modified on April 23, 2024

The instructions below describe how to set up an Appium instance on a macOS machine and to configure it to manage Android devices.

1. Install Homebrew, Carthage, and Node.js

  1. Install Homebrew (it’s a package management system that makes it easier to install software on Mac OS machines).

    Please find Homebrew and follow the instructions on this website:

    https://brew.sh/

  2. Install Carthage (a dependency manager). To do this, open the Terminal window and run the following command:

    brew install carthage
  3. Install Node.js and NPM. To do this, run this command:

    brew install node

2. Install Java

  1. Download the JDK from this website:

    https://www.oracle.com/java/technologies/javase-downloads.html

    Run the dowloaded installer and follow the instructions you will see on screen.

  2. Run the following command in the Terminal:

    /usr/libexec/java_home --v

    This will output a string like /Library/Java/JavaVirtualMachines/jdk1.8.0_171.jdk/Contents/Home. This is the location of the JDK on your computer. Copy this value.

  3. Open your .bash_profile file in an editor and add the following two lines to it:

    export JAVA_HOME="copied-path-to-JDK-directory"
    export PATH=$JAVA_HOME/bin:$PATH

    Save the changes.

    Restart the Terminal to grab the new .bash_profile settings.

3. Install Appium

You can do this in one of the following ways:

  • Install Appium Desktop. You can download the installer from this website:

    https://github.com/appium/appium-desktop/releases

    Please note that this method of installing Appium is neither recommended nor supported.

    — or —

  • Install Appium with npm. Run the following command in the Terminal window:

    npm install -g appium

Tip: We also recommend that you install the Appium Doctor in addition to Appium. It will help you fix issues with Appium and Android settings easier. To install the Doctor, run the following command in the Terminal:

npm install -g appium-doctor

4. Install AndroidStudio

Download the installation package from the following website:

https://developer.android.com/studio/

Run the installer and follow the instructions you will see on the screen.

When installing, make sure to select the Android Virtual Device component.

5. Configure AndroidStudio and Android SDKs

  1. Start AndroidStudio.

  2. In the Welcome dialog box, select Configure > SDK Manager. This will open the SDK Manager dialog box:

    • On the SDK Platforms tab, select the SDKs that you will need for testing.

      Select at least one SDK.
    • Switch to the SDK Tools tab and make sure the following tools are selected there:

      • Android SDK Build-tools
        Note: Select the latest available version.
      • Android SDK Platform-Tools
      • Intel x86 Emulator Accelerator (HAXM installer)
    • Copy the value of the Android SDK Location box at the top of the SDK Manager dialog. We will need this value later:

      Copy Android SDK location
  3. Now you need to specify the path to Android SDKs in the ANDROID_HOME environment variable. To do this, open the bash_profile in an editor and add the following lines to it:

    export ANDROID_HOME="copied-Android-SDK-location"
    export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

  4. Restart the Terminal to get changes made to your .bash_profile. Run the following command to ensure it does not cause an error:

    adb

    (Optional) You can also run Appium Doctor to see if anything else requires configuring before you start testing:

    appium-doctor

6. Install Gradle

Run the following command in the Terminal:

brew install gradle

After the installation is over, check the gradle version by running this command:

gradle -v

7. Install Maven

  1. Run the following command in the Terminal:

    brew install maven

    Check the maven version by running this command:

    mvn -version

  2. Open your .bash_profile file in an editor and add the following line to it:

    export PATH="/usr/local/Cellar/maven/version-number/bin:$PATH"

    To get the version-number, go to /usr/local/Cellar/maven/. Look at the names of subdirectories there. These are available versions. Select the version you need.

After Appium is set up and configured, you can connect to it from your TestComplete computer to create and run tests. See Connecting to Mobile Devices and Opening Testing Sessions.

See Also

Connecting to Mobile Devices and Opening Testing Sessions
Set up Appium Server
Testing iOS Applications - Tutorial

Highlight search results