Skip to content

Virtual Devices

Virtual devices are Android devices pre-configured and deployed by Genymotion Desktop. They allow you to deploy and test your own application with the sensors and features provided by Genymotion Desktop. This section explains how to manage and run virtual devices, deploy an application, emulate sensors and features, interact with virtual devices and generate their logs. It also lists the keyboard shortcuts available in virtual devices.

Managing virtual devices

Your installed Android virtual devices are displayed in Genymotion Desktop main window:

Genymotion main window

Start a virtual device

Quick boot

3.3.0 - Paying

Warning

  • Quick boot is only available with QEMU hypervisor.
  • It is not supported on Windows systems yet.

You can quick boot a virtual device using one of the following methods:

  • Double-click on the virtual device
  • Click
  • Right-click on the virtual device and select Quick boot
  • Click and select Quick boot

Note

If quick boot is not available, all these methods default to Cold boot.

Cold boot

To perform a cold boot, right-click on the virtual device, or click , and select Cold boot.

Configure a virtual device

Right-click on the device, or click , and select Edit. The Edit virtual device window opens:

Virtual device settings

From this window, navigate to the various tabs to change the virtual device settings.

GENERAL

Name

Name of your virtual device. You can set a different name if necessary.

OS Image

Information about the OS image (Android version, Source, etc.). This cannot be edited: the Android version can only be changed when creating a new device.

SYSTEM

system tab

In this section, you can change the following system settings:

Processor(s)

Sets the number of processors used by the virtual device. Default value is the recommended one for an optimal use.

When defining more processors than default, we advise setting one less than the total amount of processors to leave one dedicated to the host and avoid performance and stability issues.

Memory size

Sets the memory space allocated to the virtual device. The value must be below the memory of your computer and take into account the memory space used by your computer.

Set the values recommended for the real devices (512MB to 2048MB) for optimal result.

VM Heap size

Sets the amount of memory allocated by the Java Virtual Machine (JVM) per application. Default value is 256MB, use bigger value if you wish the garbage collector to run less frequently.

DISPLAY

display tab

Primary Display

Sets the screen size and density of the device primary display. You can either select a predefined resolution from the drop-down list, or set a custom resolution.

Warning

You may experience display or performance issues when using custom screen size and density values.

Options

Miscellaneous display options:

Rounded corner radius

Set radius of the display corners to add a rounded effect. Value must be set in density independent pixels (dp).

Rounded corner content padding

Set the padding of the rounded corner content. Value must be set in density independant pixles (dp).

Window style
Windowed (default)

Run the device in a system window.

Full screen

Run the device in full screen.

Advanced

Force the OpenGL ES maximum API version (default: 3.1).

ANDROID OPTIONS

android opt

Show Android navigation bar

Check to show Android navigation bar (default: on).

Use virtual keyboard for text input

Check to enable Android virtual keyboard (default: off).

HYPERVISOR OPTIONS

Info

This option is only available with VirtualBox hypervisor.

hypervisor opt

Set the hypervisor Network mode:

NAT

Network Address Translation (NAT) is the simplest way of accessing an external network from a virtual device. It does not require any configuration on the host network. For this reason, it is the default networking mode.

Bridge

In Bridged mode, the virtual device is a full participant in the physical network. It can contact other machines on the network and can be contacted by other machines as if it were a physical computer on the network.

Warning

In Bridged network mode, you must select the interface on which you want to apply the bridge and the network needs to have a DHCP server or router to provides a valid IP address for the virtual device.

Other

Right-click the device, or click , and select:

  • Delete to delete a device.
  • Duplicate to copy a device.
  • Factory reset to reset a device to factory settings.
  • Generate logs to generate device specific logs.

Interacting with virtual devices

This chapter describes features that help you easily interact with your virtual devices.

Multi-touch gestures

Touchscreen

Genymotion Desktop supports touchscreen: touch and multi-touch can now be performed on your touchscreen, as on a real mobile or tablet device.

With mouse and keyboard

If you don't use or have a touchscreen, multi-touch is also simulated with the mouse and keyboard:

Action Windows/Linux macOS
Zoom in Ctrl +
Zoom out Ctrl +
Tilt forth Ctrl +
Tilt back Ctrl +
Rotate clockwise Shift + Shift +
Rotate counterclockwise Shift + Shift +

Copy and Paste

The clipboard is shared between your computer and Genymotion Desktop. Thus, you can easily copy and paste text from your computer to Genymotion Desktop, and vice versa.

Note

Clipboard sharing can be disabled in Genymotion global settings - see Clipboard sharing.

Drag'n Drop

Drag and drop a file to the virtual device display to install or upload it. The behavior of dragged and dropped files is different according to the file type:

.apk files (Android applications)

APK files are installed on the virtual device. If the same application already exists but with another signature, you can decide to override the existing application.

See Deploy an application.

.zip archives (flashable archives)

Zip archives detected as flashable (containing a /system folder) are flashed on the device. Flashable archives may damage your virtual device. We recommend making a backup of the device (cloning) before flashing it.

Other (regular files)

Regular files will be uploaded to /sdcard/Download. They can be accessed via the Amaze or File Explorer applications provided in the virtual device.

Display tips

When navigating within a virtual device, you can:

  • toggle full-screen by pressing Ctrl+Shift+F (or Ctrl+Fn+F on macOS).
  • resize the virtual device window by selecting and dragging an edge or a corner of the window.
  • fit to content: when the virtual device window is resized, black areas appear on the borders. Double-click in one of those areas to fit the virtual device window size to its content.

Generating logs

In some cases, notably for assistance purposes, you may need to generate a log archive:

  1. Select HelpGenerate logs from Genymotion launcher (dashboard).
  2. Select the path to save the generated archive.
  3. Wait until the archive is generated and click Close.

Note

To generate logs for a single virtual device, right-click on the device, or click , and select Generate logs.

Virtual device shortcuts

Note

For shortcuts related to the use of the application, please refer to Genymotion Desktop shortcuts.

From Genymotion Deskotp 3.3.0 onwards, shortcuts can be viewed and customized with the Settings widget.

Back to top