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:
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:
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¶
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¶
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¶
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.
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.
.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.