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.

2. Install Android Studio and SDK.

3. Configure Environment Variables.

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.

1. Appium Server: https://appium.io

2. Appium Inspector: https://github.com/appium/appium-inspector/releases

Download and install Android Studio:

Android Studio: 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.

Configure Environment Variables:

Now that we've installed android studio, we have to create an environment variable called ANDROID_HOME and give it the path to the SDK folder which was installed with android studio.

1. Open the SDK folder and copy it's path, it should be here: C:\Users\%UserProfile%\AppData\Local\Android\Sdk

2. Open the search bar and type environment variables then press enter

3. Under system variables, click on new, and set variable name to ANDROID_HOME, then paste the path to SDK inside vale value, as seen below:

4. now we have to set two additional paths, one to platform-tools and another one to tools

under system variables, double click on path and click on new, now copy the path to platform-tools folder and paste it inside, do the same to the tools folder, seen below:

and that's it, you're all set!

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.