Oxygen for Mobile Installation

Oxygen can run automation scripts on mobile devices (Native and Mobile Web, iOS and Android).

Mobile Installation & Configuration

To create and execute mobile test automation in Oxygen, we'll need to install and configure a few things:

  1. Install Appium Desktop (see following section for instructions and links)

  2. Download and install Android Studio, or alternatively, install just the Android SDK tools - see below)

  3. Configure ADB on your PC.

  4. Optional steps: Enable Developer Mode on Windows 10 machines, if you wish to use Appium Desktop for automation of Windows 10 application.

  5. Optional steps: Install WinAppDriver version 1.1 if you wish to use Appium Desktop for Automation with Windows applications.

Mac users: Make sure that you have Xcode installed and. Open the Mac App Store application, search for "Xcode", install and/or update it. See additional details for Xcode installation on the following page: Mac Installation Troubleshooting

Please ensure that you've installed Java for Mac as detailed in the first section above.

Note: scroll down to see cofiguring ADB for Mac

Download and install Appium Desktop

Recording can be done using specially build Appium Desktop version with added recording support for Oxygen.

Android studio:

Android Studio Download link: https://developer.android.com/studio

Note: If you have wish to save disk space you may try to Download and install only the SDK tools instead of the entire Android studio: https://developer.android.com/studio#downloads Scroll a little to the bottom and you will see SDK tools download. We do not recommend that since users sometimes encounter issues configuring appium and ADB without the entire Android Studio.

Configuring your ADB

ADB - is a short for Android Debug Bridge, it allows us to have the infrastracture of basic communication with physical devices /simulators that are connected to our computer

Go to the path where the folder: 'Platform Tools' is located(where you installed the Android Studio SDK tools from above), and follow these steps:

Configure ADB for Windows Users (Updated for windows 10)

We need to edit the Environment Variables which is located in System Properties -> Advanced -> Environment Variables

  1. Click in the Windows Search box, enter "Environment" and press enter. You may also click on the suggestion: "Edit the System Environment Variables" based on your search.

  2. Click on the "Advanced" tab.

  3. Click "Environment Variables". In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New.

  4. In the Edit System Variable (or New System Variable) window, specify the value of the PATH environment variable (in the following example its : "C:\Users\[YOUR_USER]\AppData\Local\Android\Sdk\platform-tools") and click OK.

  5. Add JAVA_HOME variable : Create new variable like before , but name it: 'JAVA_HOME' , and insert the value of a path to your JRE or JDK (the folder that contains 'java.exe'), like in the following picture:

  6. Add ANDROID_HOME variable : Create new variable like before , but name it: 'ANDROID_HOME' , and insert the value of a path to your SDK (the folder that contains the folders: 'platform-tools' and 'build-tools'), like in the following picture:

If you are the administrator of the computer - there should be no issues adding these environment variables in your system variable, but if you add it to a certain user, you must run the Appium Desktop and commands from cmd using the specific user. There could be permission issues so you need to make sure you are doing the configuration properly and all under one user.

Checking that adb is configured properly

Now in order to check if adb is configured open command line, and type : 'adb devices' and press Enter. You will now receive a list of all available devices that are connected to your machine.

Unlocking Developer options (Android only)

In order to work with Appium Desktop - you must enable USB debugging , which is only possible while in Developer mode (No worries, it does not harm your phone). You can do it simply by following these steps:

  1. Go to settings screen

  2. Click 'System settings'

  3. Click 'About phone'

  4. Tap 10 times on 'Build number' - and you should receive a message the developer options are unlocked.

  5. Go to Developer options (located differently on different phones).

  6. Toggle 'USB debugging' on.

And that's it, your phone is now ready for mobile automation!

Recognizing your phone using adb commands

In order to see that everything worked well , you need to write the following command in your command line: 'adb devices'.

The list of all devices attached to your computer will be shown.

Set ADB for MAC Users

Setting up ADB on a MAC machine instructions may be found here: https://stackoverflow.com/questions/17901692/set-up-adb-on-mac-os-x .

If you already have Android Studio installed, follow these instructions:

  1. Add platform-tools to your path

    echo 'export ANDROID_HOME=/Users/$USER/Library/Android/sdk' >> ~/.bash_profile
    echo 'export PATH=${PATH}:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools' >> ~/.bash_profile
  2. Refresh your bash profile (or restart your terminal app)

    source ~/.bash_profile
  3. Start using adb

    adb devices

Checking adb is configured properly

Now in order to check if adb is configured open command line, and type : 'adb devices' and press Enter. You will now receice a list of all available devices that are connected to your machine.

Unlocking Developer options (Android only)

In order to work with Appium Desktop - you must enable USB debugging , which is only possible while in Developer mode (No worries, it does not harm your phone). You can do it simply by following these steps:

  1. Go to settings screen

  2. Click 'System settings'

  3. Click 'About phone'

  4. Tap 10 times on 'Build number' - and you should receive a message the developer options are unlocked.

  5. Go to Developer options (located differently on different phones).

  6. Toggle 'USB debugging' on.

And that's it, your phone is now ready for mobile automation!

Recognizing your phone using adb commands

In order to see that everything worked well , you need to write the following command in your command line: 'adb devices'.

The list of all devices attached to your computer will be shown.