# 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

To deploy an application to a virtual device, use either of the following methods.

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.

# Automatic method

Go to the Application panel from the main page:

Application panel

  1. Click on ADD APP
  2. Browse to your APK file and click ADD

This will automatically create an instance and install your application.

Important

You cannot deploy 100MB+ APK files with this method.

# Manual methods

To use these methods, 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).

adb install <application.apk>
  • Install the application using Google Play Store. To do so, you will need to install the Open GApps package. See Installing Open GApps.

# 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.

Important

Your virtual device must run Android 4.4 and above.

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 OpenGApps package (see Applications with native ARM code)

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.
    File upload
    Then Choose INSTALL
    Install Open GAPPS
  2. Wait for the package to upload and install.
  3. When done, you will be prompted to reboot the virtual device.
  4. (Optional) Open the Play Store and configure your account.

# Applications with native ARM code

Important

Genymotion does not support arm64-v8.

Genymotion virtual devices architecture is x86 (32-bit). If your application relies on ARM native code, you must install an ARM translation tool to make it work. The ARM translation tool must match your virtual device Android version:

Warning

For legal reasons, Genymobile cannot provide you with any ARM translation tools.

# Graphical method

  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, with adb (see gmsaas - Connect an instance to adb):

    adb reboot
    
  3. Verify that the translation tools have been properly installed with this command:

    adb shell getprop ro.product.cpu.abilist
    

    If successful, this should return x86,armeabi-v7a,armeabi

  4. Save your device to keep the changes (see Saving a virtual device)

  5. Install your APK file with one of the manual methods

# Command line method with ADB

  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/
    
  3. Flash the tools:

    adb shell /system/bin/flash-archive.sh /sdcard/Download/Genymotion-ARM-Translation_for_X.x.zip
    
  4. Once complete, reboot the virtual device with adb reboot

  5. Save your device to keep the changes (see Saving a virtual device)

  6. Install your APK file with one of the manual methods

# 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 that a minute to complete.

    Saved virtual devices are stored in the Templates section: Saved Templates

    You can also overwrite an already customized virtual device using Menu running device and Save