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:

Select Help → Generate logs from Genymotion launcher (dashboard).
Select the path to save the generated archive.
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.