Setup (OS X)

Setup Instructions for Mac OSX (10.6/10.7)

---

• 10.6 users may have to install the python library argparse to properly use the script runner utilities. To check if you have it installed, issue the following command:

    $ python -m argparse

If you need to install argparse check out the project page

• Optional: Add the following line to your ~/.bashrc file:

    export ANDROID_HOME="/path/to/android/sdk"

replacing the path with your Android SDK installation location. If you don't do this, you'll need to specify the path using the --android-home option when executing robotmonkeyrunner.

• IMPORTANT: When referencing your home directory in ANDROID_HOME, use the variable $HOME instead of a tilde (~). Java's classloader won't expand this correctly and you'll end up seeing java.lang.NoClassDefFoundError.

---

• Download and unpack the latest version from GitHub.

• Launch an Android emulator, or connect a device. Run the following command (if adb is in not in your PATH, replace adb with the appropriate absolute path):

    $ adb devices

which should start the adb server if it's not already running and show you a list of attached devices.

• cd into the unpacked archive and issue the following command:

    $ ./robotmonkeyrunner examples/sanity-test

which will execute the provided sanity test suite, which will PASS if RobotFramework can be launched, the Sikuli libs can be loaded and your device/emulator can be debugged.