# Basic Steps

In this section, you will find the basic steps to setup, launch and use a virtual device instance.

# Starting a virtual device

  1. Select a template from the Default templates section in the Resources view (see Graphical Interface) that matches the device you wish to emulate.
  2. Click Device Menu and Play Start

# Stopping a virtual device

Warning

Closing your web browser or logging out will not stop your running virtual devices; they have to be stopped manually.

To stop a running device, click settings from the device webUI and select Stop:

Stopping device from webui

You can also stop it from the main page:

Stopping device from homepage

# Deploying an application

Important

If installing an application fails, it may mean that it uses ARM code. For more information, please refer to Applications with native ARM code. Genymotion SaaS does not support arm64/aarch64.

To deploy an application to a virtual device, you first need to create and launch a new instance (see Starting a virtual device) or launch a saved instance (see Saving a virtual device). Then, use either one of the following methods:

# Drag and drop

Drag and drop the application APK file into the virtual device window.

# File upload widget

See Features and Emulated Sensors - File Upload.

# With ADB

Connect ADB to your virtual device (see gmsaas command line tool - Connect an instance to adb for instructions). And run the following command:

adb install <application.apk>

# Install the application using Google Play Store

To do so, install the Open GApps package. This will install Google Play Store.

# Installing Open GApps

The application you are developing or testing may require an interaction with Google Play Services (e.g.: in-app purchasing, advertising, etc.). However, for Intellectual Property reasons, Google Apps (Gmail, Drive, Calendar...) and Google Play services are not included in Genymotion virtual devices by default. You need to install them via Open GApps.

Disclaimer

GENYMOBILE SAS assumes no liability whatsoever resulting from the download, install and use of Google Play Services within your virtual devices. You are solely responsible for the use and assume all liability related thereto. Moreover, GENYMOBILE SAS disclaims any warranties of any kind, either express or implied, including, without limitation, implied warranties of merchantability, or fitness for a particular purpose regarding the compatibility of the Open GApps packages with any version of Genymotion.
In no event shall GENYMOBILE SAS or its affiliates, or their respective officers, directors, employees, or agents be liable with respect to your download or use of the Google Play Services and you release GENYMOBILE SAS from any liability related thereto. You agree to defend, indemnify and hold harmless GENYMOBILE SAS for any claims or costs related to your use or download of the Google Play Services.

To install the Open GApps package:

  1. From your running virtual device display, click on the File upload widget Install OpenGApps and INSTALL OPEN GAPPS.
  2. Click INSTALL
  3. Wait for the package to upload and install.
  4. When done, you will be prompted to reboot the virtual device.
  5. (Optional) Open the Play Store and configure your account.

Note

If you wish to install applications with native ARM code from Google Play Store, you have to install the ARM translation tool before the Open GApps package (see Applications with native ARM code)

# Applications with native ARM code

Genymotion SaaS virtual devices architecture is x86 (32-bit). To deploy applications for ARMv7 (32-bit), you must install an ARM translation tool which matches your virtual device Android version.

Warning

  • For Intellectual Property reasons, we cannot distribute any ARM translation tools.
  • Using ARM translation tools with Genymotion SaaS (Cloud) is not officially supported - we cannot guarantee Genymotion operations nor provide technical support in this case. Do it at your own risks!

# Install ARM translation tools

Note

  • There are no ARM translation tools for Android 10 and above.
  • ARM translation tools cannot interpret applications for arm64/aarch64.
  1. Drag'n drop the ARM translation tools zip file to the device display, or use the File upload widget.
  2. Once installed, reboot your virtual device.
  3. Verify that the translation tools have been properly installed. See Verification
  4. Save your device to keep the changes. See Saving a virtual device

Alternatively, you can install the ARM translation tools by command line:

  1. Connect your instance to ADB with gmsaas (See Contact a device to ADB)
  2. Upload the ARM translation tools zip file to the device with this command:
adb push Genymotion-ARM-Translation_for_X.X.zip /sdcard/Download/
  1. Flash the tools:
adb shell /system/bin/flash-archive.sh /sdcard/Download/Genymotion-ARM-Translation_for_X.x.zip
  1. Once complete, reboot the virtual device with adb reboot
  2. Save your device to keep the changes (see Saving a virtual device)

# Verification

Use the following ADB command to verify the ARM translation tools installation:

adb shell getprop ro.product.cpu.abilist

This should return x86,armeabi-v7a,armeabi. If not, the installation has failed.

# Install your application

Install your APK file using Drag'n drop, File upload or with adb.

# Saving a virtual device

From a predefined template, once your setup is done, you can save your virtual device.

  1. Within your virtual device user interface, click Menu running device and Save as

  2. Name your virtual device. This will stop the running device, start the template saving process and redirect you to the Resources page with the Templates filter on.

    Note

    Your template will appear as "saving" in the Templates list. The saving process should take less than a minute to complete.

Saved virtual devices are stored in the Templates section:

Saved Templates

You can also overwrite a saved virtual device by clicking Menu running device and Save