8/20/2019 Genymotion 2.5.2 User Guide
1/75
User guideVersion 2.5.2 | July 17th, 2015
8/20/2019 Genymotion 2.5.2 User Guide
2/75
Copyright
No part of this document may be reproduced or transmitted
in any form or by any means, without prior written
permission of Genymobile.
Android is a trademark of Google Inc.
Genymotion 2.5.2 User Guide
Copyrig
8/20/2019 Genymotion 2.5.2 User Guide
3/75
Genymotion 2.5.2 User Guide
Table of Conten
Table of contents
Overview 5
Requirements 6
Operating system 6
Hardware 6
Software 6
Web browser 7
Installing Genymotion 8
Windows 8
Mac OS X 9
Linux 9
License 11
Registering the license key 11
Validating the license 12
Enablingthe license server 13
Getting Started 14
Genymotion Application 19
Starting Genymotion 19
Adding a new virtual device 20
Starting avirtual device 24
Configuring Genymotion 24Getting Genymotion details 31
Gettinghelp 31
UpdatingGenymotion 31
Virtual Devices 32
Managing virtual devices 32
Starting virtual devices 35
Deployingan application 36
Emulating sensors and features 37
Interactingwith virtual devices 45
Updating virtual devices 47
Generating virtual device logs 48
Genymotion Plugin for Eclipse 50
Installing the plugin 50
Using the plugin 51
8/20/2019 Genymotion 2.5.2 User Guide
4/75
Genymotion 2.5.2 User Guide
Table of Conten
Running Android applications 52
Genymotion Plugin for Android Studio 53
Installing the plugin 53
Using the plugin 54
Running Android applications 55
Genymotion Shell 56
Starting Genymotion Shell 56
Interacting with Genymotion Shell 56
Interacting with virtual devices 56
Baseband commands 59
Interacting with Genymotion 60
Using Genymotion Shell from a command prompt 61
Keyboard Shortcuts 62
Genymotion shortcuts 62
Virtual device shortcuts 63
Glossary 66
Index 71
8/20/2019 Genymotion 2.5.2 User Guide
5/75
Overvie
Genymotion 2.5.2 User Guide
Overview
Genymotion is an Android emulator which comprises a complete setof sensors and features in
order to interact with a virtual Android environment. WithGenymotion, you can test your
Android applications on a wide range of virtual devices fordevelopment, test and
demonstration purposes.
Genymotion is fast, simple to install and powerful thanks touser-friendly sensor widgets and
interaction features. It is available for Windows, Mac OS X andLinux operating systems.
This user guide will take you through Genymotion download andinstallation steps and will help
you get familiar with the interface so that you can make fulluse of Genymotion resources and
have a fully operational application.
In this user guide, the following instructional icons areused:
Notes, tips or additional information.
Situations that could cause performance issues or datalosses.
Follow the simple installation process, start one of the Androidvirtual devices and enjoy playing
with your application!
8/20/2019 Genymotion 2.5.2 User Guide
6/75
Requiremen
Genymotion 2.5.2 User Guide
Requirements
This chapter lists the prerequisites for an optimal use ofGenymotion.
Operating system
Genymotion is compatible with the following operatingsystems:
Microsoft Windows Vista, 7, 8/8.1 (32 or 64 bits);
Mac OS X 10.8 or above;
Linux Ubuntu 12.04 (Precise Pangolin) or above;
Linux Debian 7 ( Wheezy).
Genymotion cannot be run from a virtual machine. Indeed, itneeds a
direct access to the hardware in order to provide OpenGLacceleration.Running Genymotion from a virtual machine prevents itto directly access
the hardware components. Therefore, Genymotion is incompatiblewhen
installed from VMWare, Parallels, Hyper-V or VirtualPC.
Hardware
Genymotion implies that you have the following hardware on yourcomputer:
OpenGL 2.0 capable video card, with an up-to-date driver;
VT-x or AMD-V capable CPU, enabled in BIOS settings;
RAM memory: at least 2GB;
Screen resolution greater than 1024 x 768 pixels;
Free space on hard disk: at least 100MB.
A minimum of 2 GB of free space is required to deploy avirtual device.
You might need more than 8GB depending on your use of thevirtual
devices and the applications you have installed.
Software
To run Genymotion virtual devices, you must install Oracle VMVirtualBox 4.1 or above.
However, for performance reasons, we recommend using version4.3.12.
For more information, please refer to chapterInstallingGenymotion.
8/20/2019 Genymotion 2.5.2 User Guide
7/75
Requiremen
Genymotion 2.5.2 User Guide
Web browser
For installation, updates and services provided by theGenymotion website, one of the following
web browsers is required:
Internet Explorer: version 10 or a bove;
Mozilla Firefox: version 3.0 or above;
Google Chrome: version 2.0 or above;
Safari: version 4.0 or above.
8/20/2019 Genymotion 2.5.2 User Guide
8/75
Installing Genymotio
Genymotion 2.5.2 User Guide
Installing Genymotion
Genymotion operation relies on the use of Oracle VM VirtualBoxin the background. This
enables virtualizing Android operating systems. If you do notalready have Oracle VM
VirtualBox installed on your computer, you will be asked to doso prior to installing
Genymotion.
If you already have Oracle VM VirtualBox installed, note thatversions
below 4.1.1 are not compatible with Genymotion. Forperformance
reasons, we recommend using version 4.3.12.
To install Genymotion on your computer, follow the stepscorresponding to your operating
system.
Windows
To download Genymotion for Windows:
1. Go to theGenymotion download page.
From this page, you can:download the ready-to-run Genymotioninstaller for Windows (recommended).
This package includes Oracle VM VirtualBox installer.
download the Windows 32/64-bit package.
In this case, you must first download andinstallVirtualBox for Windows hostsfrom the
Download VirtualBox page.
When installing VirtualBox, in the Custom setup window, make
sure VirtualBox Networking is enabled.
2. Save and run the .exe file.
3. Select the setup language and clickOK. Bydefault, the Genymotion language corresponds
to your system language.
The Genymotion setup wizard opens.
4. ClickNext.
5. Select the destination folder byclickingBrowse.
The default destination folder isC:\ProgramFiles\Genymobile\Genymotion.
6. ClickNext.
7. Select the start menu folder by clickingBrowseor checkDon't create a Start menu folderandclickNext.
8. Select whether or not to create a desktop icon andclickNext.
https://www.genymotion.com/#!/downloadhttps://www.virtualbox.org/wiki/Downloadshttps://www.virtualbox.org/wiki/Downloadshttps://www.genymotion.com/#!/download
8/20/2019 Genymotion 2.5.2 User Guide
9/75
Installing Genymotio
Genymotion 2.5.2 User Guide
9. ClickInstall and Finish.
Genymotion installer may not run properly on Windows Vista. Ifso:
1. ClickStart > Run.
2. Entercmd.exeand clickOK.
3. In the command prompt, start Genymotion installer packageby
entering its full path: %USERPROFILE%\Downloads\.
MacOS X
To download Genymotion for Mac OS X:
1. Download and installVirtualBox for OS Xhostsfrom the Download VirtualBox page.
When installing VirtualBox, in the Custom setup window, makesure
VirtualBox Networking is enabled.
2. When finished, reboot.
3. Go to the Genymotion download page.
4. Download the Mac OS X 64-bit package.
5. Open the.dmg file.
6. Drag and drop Genymotion and Genymotion Shell totheApplicationsdirectory.
Linux
Almost every GNU/Linux system comes with an installer packagefor Oracle VM VirtualBox.
1. Browse for the Oracle VM VirtualBox installer in yourdirectories.If you do not have the installer or if you need toinstall a specific version, download and
installVirtualBox for Linux hostsfrom the DownloadVirtualBox page.
When installing VirtualBox, in the Custom setup window, makesure
VirtualBox Networking is enabled.
2. Go to the Genymotion download page.
3. Download the Linux package corresponding to yoursystem.
4. Run the following commands:
chmod +x /genymotion-_
.bin
cd
./genymotion-_.bin -d
https://www.genymotion.com/#!/downloadhttps://www.virtualbox.org/wiki/Downloadshttps://www.genymotion.com/#!/downloadhttps://www.genymotion.com/#!/downloadhttps://www.virtualbox.org/wiki/Downloadshttps://www.genymotion.com/#!/downloadhttps://www.virtualbox.org/wiki/Downloads
8/20/2019 Genymotion 2.5.2 User Guide
10/75
Installing Genymotion
Genymotion 2.5.2 User Guide
5. Run Genymotion using the following command:
cd
./genymotion
Make sure that the dkms package is installed andthat it compiles
VirtualBox kernel modules each time a new kernel update isavailable.To do so, runsudo /etc/init.d/vboxdrv status. Youshould get
the message "VirtualBox kernel modules (vboxdrv, vboxnetflt,
vboxnetadp, vboxpci) are loaded". If not, force VirtualBoxkernel modules
compilation by running sudo /etc/init.d/vboxdrvsetup .
Make also sure that you are part of thevboxusersgroup. If not, run
sudo usermod -a -G vboxusers .
8/20/2019 Genymotion 2.5.2 User Guide
11/75
License
Genymotion 2.5.2 User Guide
License
If your company uses a Genymotion license server, you can ignorethis chapter and refer
directly to chapterEnabling the license server.
This chapter details the license registration and validationsteps.
To register your license key, you must have a valid Genymotionaccount.
To create your account, please visit theAccountcreationpage.
Registering the licensekey
To register your Genymotion license key:
1. Start Genymotion in one of the following waysdepending on your operating system:
Windows: Click from your desktop.MacOSX: Click fromtheApplicationsdirectory.
Linux: Run /genymotion.
2. Click orCtrl + A.
TheAbout Genymotionwindow opens:
3. Copy and paste your license key in theLicense keyfield and clickRegister.
If you are not already logged, enter your username and passwordin the Credentialswindow
https://www.genymotion.com/#!/auth/account-creation
8/20/2019 Genymotion 2.5.2 User Guide
12/75
License
Genymotion 2.5.2 User Guide
and clickSign in:
If you have any problems registering your license key, pleasecontact us via the Supportpage.
Validating the license
To validate your license, you need to be connected to theInternet. The Genymotion application
automatically connects to your Genymotion account. If yourlicense key is valid, your
application will be fully unlocked and all correspondingfeatures will be available.
If Genymotion cannot connect to your account for several days,the license switches to the free
version, until the next connection of theGenymotionapplication to your account. This ensures
nobody else uses your license.
When your license is about to expire, Genymotion prompts you tosign in to your account.
https://www.genymotion.com/#!/support#contacthttps://www.genymotion.com/#!/support#contact
8/20/2019 Genymotion 2.5.2 User Guide
13/75
Enabling the license server
Genymotion 2.5.2 User Guide
Enabling the license server
This section is only intended to users whose company hassubscribed to the license server.
The license server 1.0 is only compatible with Genymotion 2.5.1andgreater.
This section explains you how to get ready to use Genymotionwith the license server. To start
using Genymotion:
1. Create a user accountfromhttps://www.genymotion.com.
2. Install Genymotion by following the steps detailed inchapterInstalling Genymotion.
3. Open Genymotion.
4. Go toSettings > Account.
5. Enter your username, password and license serveraddress.
Depending on your network configuration, you may need to adda
port number, eg: server_ip:8888. The default port is 443 asHTTPS
protocol is used.
6. ClickOK.
Genymotion connects to the license server and activates allfeatures available for the
license type retrieved.
In case of a problem with the license server, please contactyour IT
manager.
https://www.genymotion.com/#!/developers/user-guide%23installing-genymotionhttps://www.genymotion.com/#!/auth/account-creation
8/20/2019 Genymotion 2.5.2 User Guide
14/75
Getting Started
Genymotion 2.5.2 User Guide
Getting Started
To start using Genymotion and test your Android application,follow the steps below:
1. Start Genymotion in one of the following waysdepending on your operating system:Windows: Click from yourdesktop.
Mac OS X: Click from theApplicationsdirectory.
Linux: Run /genymotion.
The Genymotion main window opens:
2. In the following window, clickYes:
8/20/2019 Genymotion 2.5.2 User Guide
15/75
Getting Started
Genymotion 2.5.2 User Guide
The Select a new virtual device window opens:
3. ClickSign in.
The Credentialswindow opens:
8/20/2019 Genymotion 2.5.2 User Guide
16/75
Getting Started
Genymotion 2.5.2 User Guide
4. Fill in the fields with your username and password andclickSign in.
TheAvailable virtual deviceslist appears:
5. Select a virtual device from the list andclickNext.
If you cannot add a virtual device at this step, you may berunning out
of free space. We recommend that you check the free remainingspace
on your hard disk.
The Create a new virtual device window opens:
8/20/2019 Genymotion 2.5.2 User Guide
17/75
Getting Started
Genymotion 2.5.2 User Guide
6. Enter a name for your new virtual device andclickNext.
Your virtual device is being downloaded and deployed:
7. ClickFinishto close the deploymentwindow.
Your virtual device appears in the Genymotion main window:
8/20/2019 Genymotion 2.5.2 User Guide
18/75
Getting Started
Genymotion 2.5.2 User Guide
8. Click to start your newly created virtual device.
The virtual device window opens:
9. Deploy your Android application in either of thefollowing ways:
Drag and drop the application APK file into the virtualdevice window.
Run the following command: adb install .apk.
Download and install the application directly from the virtualdevice using a web link.
For more information about sensor and feature emulation as wellas interaction with a virtual
device, please refer to chapterVirtual Devices.
8/20/2019 Genymotion 2.5.2 User Guide
19/75
Genymotion Application
Genymotion 2.5.2 User Guide
Genymotion Application
This chapter introduces Genymotion user interface and actionsyou can perform from the
different windows. Therefore, you will learn to startGenymotion, to add and start a virtual
device, to configure the application, to get information andhelp, and finally to update
Genymotion.
Starting Genymotion
Start Genymotion in one of the following ways depending on youroperating system:
Windows: click from your desktop.
MacOSX: click from theApplicationsdirectory.
Linux: run /genymotion.
The Genymotion main window opens:
From the menu bar, you can perform the following actions:
Start the selected virtual device usingStart ;Add anew virtual device usingAdd ;
Open Genymotion settings usingSettings ;
Open the information window usingAbout ;
Open the documentation usingHelp .
8/20/2019 Genymotion 2.5.2 User Guide
20/75
Genymotion Application
Genymotion 2.5.2 User Guide
dding a new virtual device
To add a virtual device, perform the action corresponding toyour situation:
You have never created a virtual device:
When the following window pops up, clickYes:
You have already created a virtual device:Click from the mainwindow.
The Select a new virtual device window appears:
8/20/2019 Genymotion 2.5.2 User Guide
21/75
Genymotion Application
Genymotion 2.5.2 User Guide
If you cannot see any virtual device in the list, you need tosign in to your Genymotion account:
1. In the Select a new virtual device window,clickSign in:
The Credentialswindow opens:
2. Enter your username and password.
3. Choose whether or not to remember your credentials forfuture connections and click
Sign in.
For more information about deploying a virtual device, pleaserefer to chapterGetting Started.
You can then select a virtual device from theAvailablevirtual deviceslist, filter virtual devices
by Android version or device model or add a custom virtualdevice, as explained in the
procedures mentioned below.
8/20/2019 Genymotion 2.5.2 User Guide
22/75
Genymotion Application
Genymotion 2.5.2 User Guide
Filtering virtual devices by Android version
From theAndroid versiondrop-down list of theGenymotion main window, you can choose to
display only virtual devices running a specific Androidversion.
You can also filter virtual devices using the search bar.
Available versions are:
2.3.7, also known as API 10 or Gingerbread;
4.1.1, also known as API 16 or Jelly Bean;
4.2.2, also known as API 17 or Jelly Bean;
4.3, also known as API 18 or Jelly Bean;
4.4.4, also known as API 19 or KitKat;
5.0.0, also known as API 21 or Lollipop;
5.1.0, also known as API 22 or Lollipop.
Filtering virtual devices by model
From the Device model drop-down list of the Genymotion mainwindow, you can choose to
display only a certain range of virtual devices.
You can also filter virtual devices using the search bar.
Available models are:
Google devices:
Google Galaxy Nexus;
Google Nexus 9;Google Nexus 6;
Google Nexus 10;
Google Nexus 4;
Google Nexus 5;
Google Nexus 7;
Google Nexus 7 2013;
Google Nexus One;
Google Nexus S.
HTC devices:
HTC Evo;
HTC One;
HTC One X;
HTC One XL.
LG devices:
LG Optimus L3 II.
8/20/2019 Genymotion 2.5.2 User Guide
23/75
Genymotion Application
Genymotion 2.5.2 User Guide
Motorola devices:
Motorola Droid Razr;
Motorola Moto X;
Motorola Xoom.
Samsung devices:
Samsung Galaxy Note;
Samsung Galaxy Note 2;
Samsung Galaxy Note 3;
Samsung Galaxy S2;
Samsung Galaxy S3;
Samsung Galaxy S4;
Samsung Galaxy S5.
Sony devices:
Sony Xperia S;
Sony Xperia Tablet S;Sony Xperia Tablet Z;
Sony Xperia Z.
Adding a custom virtual device
If you cannot find the virtual device you need, you can select acustomizable phone or tablet
from the available ones:
Custom Phone - 4.1.1 - API 16 - 768x1280;
Custom Phone - 4.2.2 - API 17 - 768x1280;
Custom Phone - 4.3 - API 18 - 768x1280;Custom Phone - 4.4.4 -API 19 - 768x1280;
Custom Phone - 5.0.0 - API 21 - 768x1280;
Custom Phone - 5.1.0 - API 22 - 768x1280;
Custom Tablet - 4.1.1 - API 16 - 2560x1600;
Custom Tablet - 4.2.2 - API 17 - 2560x1600;
Custom Tablet - 4.3 - API 18 - 2560x1600;
Custom Tablet - 4.4.4 - API 19 - 2560x1600;
Custom Tablet - 5.0.0 - API 21 - 2560x1600;
Custom Tablet - 5.1.0 - API 22 - 2560x1600.
Once you have deployed one of those virtual devices, you canedit the RAM, screen size and
density from the Configurationmenu by clicking .
For more information about configuring virtual devices, pleaserefer to section Configuring a
virtual device.
8/20/2019 Genymotion 2.5.2 User Guide
24/75
Genymotion Application
Genymotion 2.5.2 User Guide
Starting a virtual device
After having created one or several virtual devices, they aremade available in theYour virtual
deviceslist of the Genymotion main window.
To start a virtual device:
1. Select the virtual device you wish to run.
2. Click .
For more information about running a virtual device, pleaserefer to chapterVirtual Devices.
Configuring Genymotion
When clicking from the main window, you can configure Genymotionwith different kinds of
parameters:
General;Account;
Network;
VirtualBox;
ADB;
Misc.
8/20/2019 Genymotion 2.5.2 User Guide
25/75
Genymotion Application
Genymotion 2.5.2 User Guide
General
The General tab contains some application preferences.
You can check or uncheck options according to yourpreferences.
Allow Genymotion to collect usage statistics: allowsGenymotion to retrieve usage
statistics.
This helps us understand how the application is used in order tofurther improve it.
Notify me when my license is about to expire: enables licensenotifications.Genymotion warns you when your license is about toexpire.
Notify me when Genymotion activation is about to expire: enablesactivation notifications.
Genymotion warns you when you need to renew your activation inorder to keep using the
application. To do so, you must sign in to your Genymotionaccount via the website.
8/20/2019 Genymotion 2.5.2 User Guide
26/75
Genymotion Application
Genymotion 2.5.2 User Guide
Account
From theAccount tab, you can store your credentialsfor quick connections and define a license
server address if your company uses a license server.
To store your credentials in Genymotion, you must enter yourusername and password in the
corresponding fields.
To enable the license server, specify your license serveraddress.
8/20/2019 Genymotion 2.5.2 User Guide
27/75
Genymotion Application
Genymotion 2.5.2 User Guide
Network
From the Network tab, you can modify the network settings toadapt to your Internet access.
To define your HTTP proxy settings, check the followingoptions:
Use HTTP Proxy: enables the Genymotion application to use aproxy when connecting to
the Genymotion website.
You must set your HTTP proxy address and port in thecorresponding fields.
Use authentication: enables proxy authentication.You must enteryour proxy username and password in the corresponding fields.
8/20/2019 Genymotion 2.5.2 User Guide
28/75
Genymotion Application
Genymotion 2.5.2 User Guide
VirtualBox
From theVirtualBoxtab, you can define the storagelocation of your virtual devices.
In theVirtual devicesfield, set where to storeGenymotion virtual devices by clickingBrowse.
The virtual device path must be an absolute path.
8/20/2019 Genymotion 2.5.2 User Guide
29/75
Genymotion Application
Genymotion 2.5.2 User Guide
ADB
By default, Genymotion uses its own Android tools. FromtheADBtab, you can configure
Genymotion to use specific Android tools (from the AndroidSDK).
Use Genymotion Android tools (default)is the optionenabled by default.
If you wish to use specific Android tools:
1. Download Android Developer Tools (ADT) from the ADTDownload page.
2. Extract the archive files in the folder of yourchoice.
3. CheckUse custom Android SDK tools.
4. In theAndroid SDKfield, set the path tothe Android SDK folder by clickingBrowse.
5. ClickOK.
adt-bundle\sdk\platform-tools is not a valid value.
8/20/2019 Genymotion 2.5.2 User Guide
30/75
Genymotion Application
Genymotion 2.5.2 User Guide
Misc
From the Misc tab, you can define screen capture settings, clearthe cache and create an archive
containing your logs.
You can define the following options:
Screen capture settings: defines the storage path of screenshotsand screencasts.
To define where to store screen captures, fill the Destinationfolderfield by clickingBrowse.
Cache usage: indicates the disk space used by temporaryfiles.You can remove those files by clickingClear cache.
Log files: generates an archive containing all virtual devicelogs. To do so:
1. ClickSave all logs.
2. Select the path to save the generated archive.
3. Wait until the archive is generated and clickClose.
By default, the archive containing all log files is stored inthe following folders:
Windows: %LocalAppData%\Genymobile\Genymotion\deployed\\
MacOSX: $HOME/.Genymobile/Genymotion/deployed//
Linux: $HOME/.Genymobile/Genymotion/deployed//
If you generate an archive for assistance purposes, you can sendit to us via the Support
form.
https://www.genymotion.com/#!/support#contact
8/20/2019 Genymotion 2.5.2 User Guide
31/75
Genymotion Application
Genymotion 2.5.2 User Guide
GettingGenymotion details
Click to get details on the Genymotion version you are using,your license type and
expiration date. This window also allows you to register yourlicense key.
For more information about registering a license, please referto section Registering the license
key.
Getting help
Click to open this user guide.
UpdatingGenymotion
If your virtual devices are up-to-date and a new version ofGenymotion has been released, a
pop-up window prompts you to download the latest version ofGenymotion.
To update Genymotion:
1. When the following window pops up,clickDownload.
2. Follow the steps mentioned in sectionInstallingGenymotion.
8/20/2019 Genymotion 2.5.2 User Guide
32/75
Virtual Devices
Genymotion 2.5.2 User Guide
Virtual Devices
Virtual devices are Android devices preconfigured and deployedby Genymotion. They allow you
to deploy and test your own application with the sensors andfeatures provided by Genymotion.
This chapter explains how to manage and run virtual devices,deploy an application, emulate
sensors and features, interact with virtual devices, update themand generate their logs.
Managingvirtual devices
Your deployed Android virtual devices are displayed intheYour virtual deviceslist of the
Genymotion main window:
From this list, you can:
configure a virtual device using ;
clone a virtual device using ;
reset a virtual device using ;
delete a virtual device using .
8/20/2019 Genymotion 2.5.2 User Guide
33/75
Virtual Devices
Genymotion 2.5.2 User Guide
Configuring a virtual device
When clicking , the Configuration window opens:
From this window, you can configure the followingparameters:
System
Processor(s): sets the number of processors used by the virtualdevice.By default, the value is set to 1, which is the recommendedvalue for an optimal use.
When defining more processors, we advise setting one less thanthe
total amount of processors to leave one dedicated to the hostand
avoid performance issues.
8/20/2019 Genymotion 2.5.2 User Guide
34/75
Virtual Devices
Genymotion 2.5.2 User Guide
Base memory (MB): sets the memory space allocated to the virtualdevice.
The value must be below the memory of your computer and takeinto account the
memory space used by your computer.
We advise that you set the values recommended for the realdevices
(512MB to 2048MB).
Screen size - density
Predefined: sets the screen size and density from a predefinedlist.
Custom: sets a custom screen size and density.
You may experience display or performance issues whenusing
custom screen size and density values.
Run virtual device in full-screen mode: displays the virtualdevice in full-screen mode,
adjusted to your screen size.
Android system options
Show Android navigation bar: displays the Android navigation barin the virtual device.
Use virtual keyboard for text input: uses the virtual keyboardwhen selecting a text input
area.
Cloning a virtual device
Cloning a virtual device consists in duplicating a virtualdevice. The clone contains all settings of
the original virtual device.
This feature is only available with Indie and Businesslicenses.
To clone a virtual device:
1. Select the virtual device you wish to clone.
2. Click .
3. Enter a name for the new virtual device.
4. ClickClone.
5. Wait until the cloning process is finished andclickFinish.
Resetting a virtual device
After the deployment of a new virtual device, a snapshot iscreated. Thus, you can restore the
factory settings of your virtual device at any time.
This feature is only available with Indie and Businesslicenses.
8/20/2019 Genymotion 2.5.2 User Guide
35/75
Virtual Devices
Genymotion 2.5.2 User Guide
To reset a virtual device:
1. Click .
2. In the confirmation window, clickYes.
When using Reset , all installed applications, system patches,modified
settings and data will be lost.
Deleting a virtual device
To delete a virtual device:
1. Select the virtual device you wish to delete.
2. Click .
3. In the confirmation window, clickYes.
Starting virtual devices
You can start virtual devices using either the Genymotion mainwindow or a command prompt.
From the Genymotion main window
To start a virtual device from the Genymotion main window:
1. Select the virtual device you wish to run.
2. Click .
From a command prompt
1. Open a command prompt.2. Retrieve the list ofavailable virtual devices by running:
Windows: \genyshell -c "devices list"
Genymotion default installation path isC:\Program
Files\Genymobile\Genymotion .
MacOSX: /Applications/Genymotion.app/Contents/MacOS/genyshell-
c "devices list"
Linux: /genyshell -c "devices list"
3. Start one of the virtual devices by running:
Windows: \player --vm-name ""
MacOSX: /Applications/Genymotion.app/Contents/MacOS/player--
vm-name ""
Linux: /player --vm-name ""
8/20/2019 Genymotion 2.5.2 User Guide
36/75
Virtual Devices
Genymotion 2.5.2 User Guide
After starting a virtual device, the following window opens.This is where your virtual device
runs and where you can interact with it:
For more information about deploying a virtual device, pleaserefer to section Getting Started.
Deploying an application
To deploy an application to a virtual device, use either of thefollowing methods:
Drag and drop the application APK file into the virtual devicewindow.
Run the following command: adb install .apk.
Download and install the application directly from the virtualdevice using a web link.
8/20/2019 Genymotion 2.5.2 User Guide
37/75
Virtual Devices
Genymotion 2.5.2 User Guide
Emulating sensorsand features
To simulate various behaviors of your application according tospecific use cases,
Genymotion provides easy-to-use widgets which emulate thefollowing sensors and features:
Battery;
GPS;
Camera;
Capture;
Remote control;
Identifiers;
Network;
Phone.
Battery
The Battery widget allows you to test how your applicationreacts with different battery charge
levels and states of charge.
To use the Battery widget:
1. Click .
2. Activate the battery simulation mode byclickingOn.
3. Modify the charge level using the slider or enter avalue in theCharge level field.
4. Modify the state of charge by clicking the State ofcharge button:
Click once to activate the Charging state.
This simulates that the power supply is plugged in and thebattery is charging.
8/20/2019 Genymotion 2.5.2 User Guide
38/75
Virtual Devices
Genymotion 2.5.2 User Guide
Click twice to activate the Discharging state.
This simulates that the power supply is unplugged and thebattery is discharging.
By default, the virtual device emulates the same battery chargelevel as
the one of your computer. If your computer does not have abattery
(desktop computer), the simulation mode is automaticallyactivated.
GPS
The GPS widget allows real-time activation and modifications ofa position, accuracy and
bearing.
To use the GPS widget:
1. Click .
2. Activate the GPS simulation mode by clickingOn.This enables the reception of generated
GPS frames in the virtual device.
3. Set the latitude value you wish to simulate usingtheLatitude field.
The latitude value must range from -90° to 90°.
4. Set the longitude value you wish to simulate using theLongitude field.
The longitude value must range from -180° to 180°.
5. Set the altitude value you wish to simulate usingtheAltitude field.
The altitude value must range from -20m to 10000m.
6. Set an accuracy value using the slider or by enteringa value in theAccuracy field.
The accuracy value must range from 0m to 200m.
8/20/2019 Genymotion 2.5.2 User Guide
39/75
Virtual Devices
Genymotion 2.5.2 User Guide
7. Set a bearing value using the compass or by entering avalue in theBearing field.
The bearing value must range from 0° to 359,99°.
Many applications do not rely on the GPS orientation, but usethe
device accelerometer or gyroscope to determine the bearing ofthe
device, which are not yet supported.
Camera
The Camera widget allows you to send a video stream from avirtual device to the Android
system. With this widget, you can test an Android applicationthat uses an Android built-in
camera.
The video stream can come from a dummy camera or a real physicalwebcam connected or
integrated into your computer.
To use the Camera widget:
1. Click .
2. Activate the Camera widget by clickingOn.
Genymotion detects available webcams on your computer.
3. Select the source of data you wish to use in the Frontcameraand Back camerafields. The
front camera sends data to the Android front camera and the backcamera sends data to
the Android back camera.
Dummy webcam: data are images generated by the widget;Physical(real) webcam: data are images sent by the selected webcam.
8/20/2019 Genymotion 2.5.2 User Guide
40/75
Virtual Devices
Genymotion 2.5.2 User Guide
4. ClickPreviewto see the video stream sentto the Android system. You can check the
following options:
None: does not display any data;
Front: displays the front camera data;
Back: displays the back camera data.
Capture
The Capture widget allows you to take a screenshot or screencastof virtual devices. This way,
you can broadcast images or videos of your applications.
This feature is only available with Indie and Businesslicenses.
To use the Capture widget, click .
Screenshot: When clicking , a screenshot of your virtual deviceis captured and stored in
the configured folder.
Screencast: When clicking , a video of your virtual devicestarts recording. Clicking twice
stops the recording.
If your virtual device emits sound, it will be captured in thevideo.
Browse files: When clicking , your file explorer opens, allowingyou to directly access your
screenshots and screencasts.All screenshots and screencasts arestored in your home directory, in a folder named with
your virtual device name. You can change this default folder inGenymotion Settings > Misc,
as explained in section Misc.
All features can be accessed via shortcuts even if theCapture widget is not
displayed.
8/20/2019 Genymotion 2.5.2 User Guide
41/75
Virtual Devices
Genymotion 2.5.2 User Guide
Remote control
With the Remote control widget, you can take control of avirtual device from a physical device
(any phone or tablet running Android version 2.2/API 8/Froyo orabove). This widget works
with a specific Android application that runs on the physicaldevice and forwards touch inputs
and accelerometer events to Genymotion. As a result, you cantest your application as if you
were holding a device in your hands.
This feature is only available with Indie and Businesslicenses.
The Remote control widget requires to have ADB installed on yourcomputer. For more
information, please refer to sectionADB.
To use the Remote control widget:
1. Connect your physical device either by wire or withWi-Fi.
To connect with Wi-Fi, your physical device must support ADBover network. If so:
1. On your physical device, go toMenu > System settings> Developer options.
If youhave not unlocked this menu yet, go to Menu> System
settings > Aboutand click several times onBuildnumberuntil
you get a message meaning that Developer options are now
available.
2. CheckAndroid debugging and thenADB overnetwork.
3. Connect your physical device to the Wi-Fi and retrieve its IPaddress from the Wi-Fi
menu.
4. Open a command prompt and enter \connect .
2. Click .
3. Activate the widget by clickingOn.
Genymotion tries to detect any connected Android device.
8/20/2019 Genymotion 2.5.2 User Guide
42/75
Virtual Devices
Genymotion 2.5.2 User Guide
4. Select your device from theAvailabledevicesdrop-down list and clickStart.
If the device is connected to ADB and not visible in the list,restart the
widget.
5. Check the desired options:
Enable preview: enables previewing your Genymotion screen onyour physical device.Enable touch screen: allows your physicaldevice to send touch events to Genymotion.
Enable accelerometer: allows your physical device to sendaccelerometer events to
Genymotion.
The Remote control widget automatically stops when youdisconnect your device.
Identifiers
The Identifiers widget showsDevice ID andAndroid IDnumbers. You can view and edit these
values at any time, without having to reboot your virtualdevice.
This feature is only available with Indie and Businesslicenses.
To use the Identifiers widget, click .
Android ID
An Android ID is a 64-bit number randomly generated when theuser first sets up the device.
It remains the same for the whole lifetime of the user's device.Android 4.2.2 and greater
versions support multiple user accounts, each one having aunique Android ID.
When clicking , a random Android identifier is generated. ValidAndroid ID numbers are 16-
hexadecimal digit long.
You are not allowed to set an empty Android ID.
Device ID / IMEI / MEID
By default, a new virtual device is deployed with the defaultdevice ID number
00000000000000 0.
When clicking , a random identifier is generated.
As IMEI or MEID numbers are used as device ID, Genymotiongenerates numbers compliant
8/20/2019 Genymotion 2.5.2 User Guide
43/75
Virtual Devices
Genymotion 2.5.2 User Guide
with the GSM 02.16 standard and the 3GPP2 specification (14digits or hexadecimal digits +
a checksum digit).
Valid characters for setting device ID/IMEI/MEID are:
lower-case and upper-case letters[a-z, A-Z];
digits[0-9];
dot[.];
dash [-];
underscore [_].
Network
The Network widget allows you to test how your applicationreacts with different network
quality and performance types.
This feature is only available with Indie and Businesslicenses.
To use the Network widget:
1. Click .
2. Activate the network simulation byclickingOn.
When activating the widget for the first time, the profilenetwork isautomatically set toWifi. It then takes the lastnetwork profile used.
8/20/2019 Genymotion 2.5.2 User Guide
44/75
Virtual Devices
Genymotion 2.5.2 User Guide
3. Select a network type from theProfile drop-down list.Network profiles and their
corresponding values are listed in the table below.
Uploadspeed
Downloadspeed
Uploaddelay
Downloaddelay
Uploadpacket
loss
Downloadpacket
loss
DNSdelay
No data 0Kb/s 0Kb/s 0ms 0ms 100% 100% 0ms
GPRS 40Kb/s 40Kb/s 500ms 500ms 0.01% 0.01% 1000ms
Edge 200Kb/s 240Kb/s 400ms 400ms 0.01% 0.01% 800ms
3G 1.5Mb/s 7.2Mb/s 100ms 100ms 0.01% 0.01% 200ms
4G 5.5Mb/s 17.9Mb/s 50ms 50ms 0.01% 0.01% 100ms
4G(high DNSdelay)
5.5Mb/s 17.9Mb/s 50ms 50ms 0.01% 0.01% 3000ms
4G(highpacket losses)
5.5Mb/s 17.9Mb/s 50ms 50ms 10% 10% 100ms
Wifi 33.0Mb/s 40.0Mb/s 0ms 0ms 0% 0% 0ms
Phone
The Phone widget allows to test applications relying ontelephony features and observe their
behavior when receiving a call or a text message.
This feature is only available with Indie and Businesslicenses.
8/20/2019 Genymotion 2.5.2 User Guide
45/75
Virtual Devices
Genymotion 2.5.2 User Guide
To use the Phone widget, click orCtrl + 8.
To simulate an incoming call:
1. Enter an incoming phone number.
2. ClickCall.
To simulate an incoming message:1. Enter an incomingphone number.
2. Enter a text message.
3. ClickSend message.
The text message is displayed in the virtual device via anotification and can also be read in
the Messaging application.
Interactingwith virtual devices
This section describes features that help you easily interactwith your virtual devices.
Multi-touch simulation
Because in most cases, virtual devices are controlled with mouseand keyboard, some shortcuts
have been implemented to help simulate common gestures:
Zoom in: right click + move mouse to the left
Zoom out: right click + move mouse to the right
Tilt forth: right click + move mouse up
Tilt back: right click + move mouse down
Clockwise rotation: Shift + right click + move mouse to theright
Counterclockwise rotation: Shift + right click + move mouse tothe left
If you use Mac OS X, replace right click with ctrl + click.
Drag and drop
To drag and drop files from your computer to the virtual device,ADB must be installed. To
configure ADB, please refer to sectionADB. The behavior ofdragged and dropped files is
different according to the file type:
Regular files: Regular files are stored in /sdcard/Download.
They can be accessed via the File Managerapplicationprovided in the virtual device.
Android applications: APK files are installed on thevirtual device.
If the same application already exists but with anothersignature, you can decide to override
the existing application.
8/20/2019 Genymotion 2.5.2 User Guide
46/75
Virtual Devices
Genymotion 2.5.2 User Guide
Flashable archives:
Zip archives detected as flashable (containing a/systemfolder) are flashed on the device.
Such archives may damage your virtual device. Werecommend
restarting your virtual device after flashing an archive.
Copy and pasteThe clipboard is shared between your computer andGenymotion. Thus, you can easily copy and
paste text from your computer to Genymotion, and vice versa.
Increase/Decrease volume
You can control the volume of the sound emitted by your virtualdevice:
Click to increase the volume.
Click to decrease the volume.
Rotate screen
You can rotate the screen of your virtual device by clicking.
Depending on the Android version and the density of your virtualdevice,
the Rotate screen feature may not be available. If you are usingan
Android version 4.2 or above, make sure that the Rotatescreen feature is
not locked in the right-hand bar. Rotation might also be lockedin portrait
or landscape mode by the current running application. In thiscase, it is not
possible to change it via the Rotate screen button or via the rotation
setangle command in Genymotion Shell.
Pixel Perfect
With Pixel Perfect, you can be highly precise in the developmentof your user interface and
ensure every pixel of your application really looks as itshould. One pixel of the virtual device is
displayed using one pixel of your computer screen.
This feature is only available with Indie and Businesslicenses.
Click once to activate Pixel Perfect. Click twice to deactivateit.
If the virtual device screen size is larger than your computerscreen size,
the virtual device window will be maximized and you will be ableto usescrollbars to move inside the screen.
8/20/2019 Genymotion 2.5.2 User Guide
47/75
Virtual Devices
Genymotion 2.5.2 User Guide
Navigation buttons
With the navigation buttons, you can navigate betweenapplications or display actions that can
be performed.
Back
Click once to go back to the previous page. Click twice to exitthe application.
Recent apps
Click to display the recently used applications.
Menu
Click to display actions you can perform within anapplication.
Home
Click to display the home page at any time.
Power
Click to shut down the running virtual device.
Display tips
When navigating within a virtual device, you can at any timechange its display:
Full-screen mode: You can switch to full-screen mode bypressingF11. Pressing a second
time reverts to the original screen size.
On Mac OS X, you may have to use the key combination ctrl+ fn +
F11.
Custom size: You can resize the virtual device window byselecting and dragging an edge or a
corner of the window.
Fit to content: When the virtual device window is resized, blackareas appear on the borders.
Double-click in one of those areas to fit the virtual devicewindow size to its content.
Updating virtual devices
If Genymotion is up-to-date and a new version of virtual deviceshas been released, a pop-up
window prompts you to automatically update your virtual deviceswhile keeping all your
installed packages and applications.
This is only possible with an Indie or a Business license. Ifyou are using the
free version of Genymotion, you must deploy the new version ofvirtual
devices.
8/20/2019 Genymotion 2.5.2 User Guide
48/75
Virtual Devices
Genymotion 2.5.2 User Guide
To update your virtual devices:
1. When the following window pops up,clickUpdate.
2. Wait until the update process is finished andclickFinish.
You must have the latest version of Genymotion to update yourvirtual
devices.
Generating virtual device logs
In some cases, notably for assistance purposes, you may need togenerate a log archive, either
for a specific virtual device or for all virtual devices. Followeither of the procedures below.
For one virtual device
From the Genymotion main window:
1. Right-click on the virtual device.2. ClickGenerate log archive.
3. Select the path to save the generated archive.
By default, log files are stored in the following folders:
Windows:
C:\Users\\AppData\Local\Genymobile\Genymotion\deployed\\Logs
MacOSX: $HOME/.Genymobile/Genymotion/deployed//
Linux: $HOME/.Genymobile/Genymotion/deployed//
4. Wait until the archive is generated andclickClose.
If you have generated logs for assistance purposes, you can sendthe archive or the log files to
us via the Supportform.
https://www.genymotion.com/#!/support#contact
8/20/2019 Genymotion 2.5.2 User Guide
49/75
Virtual Devices
Genymotion 2.5.2 User Guide
For all virtual devices
From the Genymotion main window:
1. Click .
2. In the Misc tab, clickSave all logs.
3. Select the path to save the generated archive.Bydefault, log files are stored in the following folders:
Windows:
C:\Users\\AppData\Local\Genymobile\Genymotion\deployed\\Logs
MacOSX: $HOME/.Genymobile/Genymotion/deployed//
Linux: $HOME/.Genymobile/Genymotion/deployed//
4. Wait until the archive is generated andclickClose.
If you have generated logs for assistance purposes, you can sendthe archive or the log files tous via the Supportform.
https://www.genymotion.com/#!/support#contact
8/20/2019 Genymotion 2.5.2 User Guide
50/75
Genymotion Plugin for Eclipse
Genymotion 2.5.2 User Guide
Genymotion Plugin for Eclipse
The Genymotion plugin for Eclipse allows you to test yourapplication developed with the
Eclipse IDE. It uses ADB to connect to any active virtual deviceand push your application. To
use the plugin, you need to have the Android Developer Toolsplugin for Eclipse installed. In this
chapter, you will be able to install, use the plugin and runAndroid applications.
Installing the plugin
You can install Genymotion plugin for Eclipse in one of thefollowing ways:
Update Site method (recommended);
Manual method.
Update Site method (recommended)
1. Start Eclipse.
2. Go toHelp/Install New Software menu andclickAdd.
3. Fill in the fields with the following values andclickOK.
Name: Genymotion
Location: http://plugins.genymotion.com/eclipse
4. Expand Genymobile.
5. ClickSelect all and clickNext.
6. ClickNext.
7. Read and accept the license terms.8. ClickFinish.
A security warning indicates that the plugin is not signed;clickOK.
9. ClickYesto restart Eclipse.
The Genymotion plugin button is displayed in the toolbar.
Manual method
1. Ensure Eclipse is closed.
2. Download the plugin from the Genymotion downloadpage.
3. Follow the steps corresponding to your operatingsystem:
Windows
If you have administrator rights, put the .jar archive in thePlugins directory of your
Eclipse installation folder.
Without administrator rights, put the .jar archive in thePlugins directory of your
Local Settings\Eclipse folder.
https://www.genymotion.com/#!/downloadhttps://www.genymotion.com/#!/download
8/20/2019 Genymotion 2.5.2 User Guide
51/75
Genymotion Plugin for Eclipse
Genymotion 2.5.2 User Guide
MacOSX
With administrator rights, put the .jar archive in the Pluginsdirectory of your Eclipse
installation folder.
Linux
If you have administrator rights, put the .jar archive in thePlugins directory of your
Eclipse installation folder.
Without administrator rights, put the .jar archive in thePlugins directory of your/home//Eclipse folder.
Using theplugin
To start using the Genymotion plugin:
1. Click .
The following window opens:
2. In the Genymotion applicationfield, browse forthe Genymotion application installation
directory:
Windows: C:\Program Files\Genymobile\Genymotion
MacOSX: /Applications/Genymotion.appLinux: /home//genymotion
3. ClickApply and OK.
4. Click to open the Genymotion Virtual DevicesManagerwindow:
From this window, you can perform the following actions:
Create a new virtual device usingNew;
This automatically starts the Genymotion creation wizard.
8/20/2019 Genymotion 2.5.2 User Guide
52/75
Genymotion Plugin for Eclipse
Genymotion 2.5.2 User Guide
Start a virtual device usingStart;
Refresh the list of virtual devices usingRefresh.
The virtual device activation status is displayed in the Statecolumn. Values can be:
Off: the virtual device is deactivated;
Paused: the virtual device has been started and paused.
The Restartaction gets back to the exact same state;
On: The virtual device is activated, but not connected toADB.
It means that you cannot select this virtual device intheAndroid Device Chooserwindow of
the ADT plugin.
Running ndroid applications
To run an Android application in the Genymotion plugin forEclipse, you first need to make sure
that your virtual device is connected to the ADB tool. To do so,please refer to sectionADB.
Then follow the steps below:
1. Click .
2. Select the virtual device you want to use andclickStart.
3. Minimize the Genymotion window.
4. Right-click on your application project andselectRun as Android application.
TheAndroid Device Chooserwindow opens.
After a reboot or an unexpected halt of a virtual device,its name in the
Android Device Chooser window may becomeirrelevant. Close and
reopen the plugin to solve this.
While the Genymotion plugin window is open, errors are displayedin the
Eclipse console.
8/20/2019 Genymotion 2.5.2 User Guide
53/75
Genymotion Plugin for Android Studio
Genymotion 2.5.2 User Guide
Genymotion Plugin for Android Studio
The Genymotion plugin for Android Studio allows you to test yourapplication developed with
the Android Studio IDE. It uses ADB to connect to any activevirtual device and push your
application. In this chapter, you will be able to install, usethe plugin and run Android applications.
Installing the plugin
You can install Genymotion plugin for Android Studio in one ofthe following ways:
JetBrains repository method (recommended);
Manual method.
JetBrains repository method (recommended)
1. Start Android Studio.
2. Go to:
Windows and Linux: File/Settings.
MacOSX: Android Studio/Preferences.
3. SelectPluginsand clickBrowserepositories.
4. Right-click (double-click for Mac OS X) onGenymotion.
5. ClickDownload and install.
6. ClickYes.
7. ClickClose.
8. ClickOK.9. Restart Android Studioby clickingRestart.
From Android Studio version 0.3.0 onwards, the toolbar,where
Genymotion plugin icon is displayed, is hidden by default. Todisplay it,
clickView > Toolbar.
Manual method
1. Download the Genymotion plugin for Android Studio fromthe Genymotion download page.
2. Start Android Studio.
3. Go to:
Windows and Linux: File/Settings.
MacOSX: Android Studio/Preferences.
4. SelectPluginsand clickInstall pluginfrom disk.
5. Select the genymotion-IDEA-plugin.jar file.
6. ClickOK.
https://www.genymotion.com/#!/downloadhttps://www.genymotion.com/#!/downloadhttps://www.genymotion.com/#!/download
8/20/2019 Genymotion 2.5.2 User Guide
54/75
Genymotion Plugin for Android Studio
Genymotion 2.5.2 User Guide
7. Restart Android Studio by clickingRestart.
From Android Studio version 0.3.0 onwards, the toolbar,where
Genymotion plugin icon is displayed, is hidden by default. Todisplay it,
clickView > Toolbar.
Using theplugin
To start using the Genymotion plugin:
1. Click .
The following window opens:
2. Browse for the Genymotion application installationdirectory:
Windows: C:\Program Files\Genymobile\Genymotion
MacOSX: /Applications/Genymotion.app
Linux: /home//genymotion
3. ClickOK.
4. Click to openthe Genymotion DeviceManagerwindow:
From this window, you can perform the following actions:
Create a new virtual device usingNew;This automaticallystarts the Genymotion creation wizard.
Start a virtual device usingStart;
Refresh the list of virtual devices usingRefresh.
8/20/2019 Genymotion 2.5.2 User Guide
55/75
Genymotion Plugin for Android Studio
Genymotion 2.5.2 User Guide
The virtual device activation status is displayed in theStatuscolumn. Values can be:
Off: the virtual device is deactivated;
Paused: the virtual device has been started and paused.
The Restartaction gets back to the exact same state;
On: The virtual device is activated, but not connected toADB.
It means that you cannot select this virtual device in theChoose Device window of the ADBplugin.
Running ndroid applications
1. Click .
2. Select the virtual device you want to use andclickStart.
3. Close the Genymotion window.
4. In your application project, click .
The Choose Device window opens.
5. Click on the virtual device you started orcreated.
After a reboot or an unexpected halt of a virtual device,its name in
the Choose Device window may become irrelevant. Close andreopen
the plugin to solve this.
6. ClickOK.
While Genymotion plugin window is open, errors are displayed inthe
Android Studio console.
8/20/2019 Genymotion 2.5.2 User Guide
56/75
Genymotion Shel
Genymotion 2.5.2 User Guide
Genymotion Shell
Genymotion provides a shell to script the modification of sensorstatuses. This chapter explains
how to use Genymotion Shell and lists the availablecommands.
Starting Genymotion Shell
To start Genymotion Shell, perform the action corresponding toyour operating system:
Windows: run C:\ProgramFiles\Genymobile\Genymotion\genyshell.exe.
MacOSX: click from theApplicationsdirectory.
Linux: run /genymotion-shell.
Interactingwith Genymotion Shell
With the commands below, you can perform various basic actionsrelated to the use of
Genymotion Shell:
help: displays the list of available commands.
pause: pauses the execution of Genymotion Shell. The value mustbe set in seconds.
version: returns Genymotion Shell version.
exit or quit: closes Genymotion Shell.
Interactingwith virtual devices
To modify sensor statuses and values of a virtual device, usethe commands listed below:
devices list
Lists available virtual devices and provides details such ascurrent status, IP address and
name.
devices refresh
Refreshes the virtual device list.
devices select
Selects a virtual device. Add the ID of the virtual device youwish to select (as displayed in the
device list).
devices pingSends a ping message to check that the virtualdevice is responding.
devices factoryreset
Resets the virtual device to factory state. Add the ID of thedevice you wish to reset (as
displayed in the device list). Adding the keyword force at theend skips the warning message
about data loss.
battery getmode
Returns the current battery mode of the selected virtualdevice.
8/20/2019 Genymotion 2.5.2 User Guide
57/75
Genymotion Shel
Genymotion 2.5.2 User Guide
battery setmode
Sets the battery mode of the selected virtual device. The modecan be:
host: the virtual battery values reflect the host battery values(if any);
manual: the virtual battery charge level and state of charge canbe manually set.
battery getlevel
Returns the current battery charge level of the selected virtualdevice. If the battery mode is
"host", the returned value is the host value.
battery setlevel
Sets the battery charge level of the selected virtual device.The value must range from 0% to
100%. This command forces the activation of the manual mode.
battery getstatus
Returns the current battery state of charge of the selectedvirtual device.
battery setstatus
Sets the battery state of charge of the selected virtual device.Values can be:
discharging: simulates that the power supply is unplugged andthe battery is
discharging.
The value ranges from 0% to 100%.charging: simulates that thepower supply is plugged in and the battery is charging.
The value ranges from 0% to 100%.
notcharging: simulates that the power supply has just beenunplugged and the battery
is not discharging yet.
The value ranges from 0% to 100%.
full: simulates that the battery is fully charged.
gps getstatus
Returns the activation status of the GPS signal reception.
gps setstatus
Sets the activation status of the GPS signal reception. Valuescan be:
enabled: the GPS signal reception is enabled;
disabled: the GPS signal reception is disabled.
gps getlatitude
Returns the current latitude value (if the GPS is activated anda latitude value is set) or 0.
gps setlatitude
Sets the latitude value (and forces the activation of the GPS ifdeactivated). The value must
range from -90° to 90°.
gps getlongitude
Returns the current longitude value (if the GPS is activated anda longitude value is set) or 0.
gps setlongitude
Sets the longitude value (and forces the activation of the GPSif deactivated). The value mustrange from -180° to 180°.
gps getaltitude
Returns the current altitude value (if the GPS is activated andan altitude value is set) or 0.
gps setaltitude
Sets the altitude value (and forces the activation of the GPS ifdeactivated). The value must
range from -20m to 10000m.
8/20/2019 Genymotion 2.5.2 User Guide
58/75
Genymotion Shel
Genymotion 2.5.2 User Guide
gps getaccuracy
Returns the current accuracy value (if the GPS is activated andan accuracy value is set) or 0.
gps setaccuracy
Set the accuracy value (and forces the activation of the GPS ifdeactivated). The value must
range from 0m to 200m.
gps getbearing
Returns the current bearing value (if the GPS is activated and abearing value is set) or 0.
gps setbearing
Sets the bearing value (and forces the activation of the GPS ifdeactivated). The value must
range from 0° to 359,99°.
rotation setangle
Sets the rotation angle value of the virtual device. The valuemust range from 0° to 359°.
android version
Returns the Android version of the selected virtual device.
android getandroidid
Returns the Android ID number of the selected virtualdevice.
This is only possible with an Indie or a Business license.
android setandroidid
Sets the Android ID number of the selected virtual device.
Values can be:
random: a random Android ID number is generated;
custom: you must enter a value containing 16 hexadecimaldigits.
This is only possible with an Indie or a Business license.
If several users exist on the Android system, the Android ID canonly
be set for the first user.
android getdeviceid
Returns the device ID (IMEI/MEID) number of the selected virtualdevice.
This is only possible with an Indie or a Business license.
android setdeviceid
Sets the device ID (IMEI/MEID) number of the selected virtualdevice.
Values can be:
none: no device ID number is generated.
random: a random device ID number is generated.custom: you mustenter a value containing alphanumeric characters, dots, dashesand/or
underscores.
This is only possible with an Indie or a Business license.
network getprofile
Returns the current network profile of the selected virtualdevice.
8/20/2019 Genymotion 2.5.2 User Guide
59/75
Genymotion Shel
Genymotion 2.5.2 User Guide
network setprofile
Sets the network profile of the selected virtual device. Valuescan be:
no-data: no network connection is simulated.
gprs: a GPRS network connection is simulated.
edge: an Edge network connection is simulated.
3g: a 3G network connection is simulated.4g: a 4G networkconnection is simulated.
4g-high-losses: a 4G network connection with packet losses setto 10% is simulated.
4g-bad-dns: a 4G network connection with a DNS delay set to3000ms is simulated.
wifi: a Wi-Fi network connection is simulated.
phone call
simulates an incoming phone call from a given phone number.
phone sms
simulates an incoming text message from a given phonenumber.
phone baseband
sends commands directly to the baseband. This has beenimplemented in order to ease scriptcreation. For more informationon the phone baseband command and its capabilities, please
refer to section Baseband commands.
Baseband commands
The phone baseband commands send raw data directly to thebaseband. In this section, you
will find all commands available in Genymotion Shell to directlyinteract with the baseband.
Commands below return results in your logcat.
gsm list
lists all incoming and outgoing phone calls and their state.
gsm call
simulates a new incoming call from a given phone number.
gsm busy
hangs up an outgoing call (performed from the integrated Dialerapplication) and reports the
remote phone as busy.
gsm hold
simulates that an incoming or outgoing phone call (performedfrom the integrated Dialer
application) is put on hold.
gsm accept simulates that the outgoing phone call (performedfrom the integrated Dialer application) is
answered.
gsm cancel
simulates that an incoming or outgoing phone call is hungup.
gsm data
modifies data connection state. Values can be:
8/20/2019 Genymotion 2.5.2 User Guide
60/75
Genymotion Shel
Genymotion 2.5.2 User Guide
unregistered or off: no network ava ilable;
home or on: on local network, non-roaming;
roaming: on roaming network;
searching: searching networks;
denied: emergency calls only.
gsm voicemodifies voice connection state. Values can be:
unregistered or off: no network ava ilable;
home or on: on local network, non-roaming;
roaming: on roaming network;
searching: searching networks;
denied: emergency calls only.
gsm status
displays the current status of the GSM emulation.
gsm signal
changes the reported strength and error rate on next (15s)update.
rssi: the value must range from 0 to 31. Returns 99 if the valueis unknown.
ber: the value must range from 0% to 7%. Returns 99 if the valueis unknown.
rs_snr: the value must range from -200 to 300.
cdma ssource
sets the current CDMA subscription source. Values can be:
nv : the subscription is read from non-volatile RAM;
ruim: the subscription is read from RUIM.
cdma prl_version
dumps the current PRL version.
sms send
simulates an incoming text message from a given phonenumber.
sms pdu
simulates a new incoming text message defined in the PDUformat.
Interactingwith Genymotion
The commands below allow you to perform actions related to theGenymotion application via
Genymotion Shell:
genymotion capabilitiesReturns Genymotion features available onthe selected virtual device.
genymotion clearcache
Clears temporary files and logs.
genymotion version
Returns the Genymotion version of the selected virtualdevice.
genymotion license
Returns information about the Genymotion license (type,validity).
8/20/2019 Genymotion 2.5.2 User Guide
61/75
Genymotion Shel
Genymotion 2.5.2 User Guide
UsingGenymotion Shell from a command prompt
You can connect to Genymotion Shell and interact with a virtualdevice from a command
prompt using the commands defined in section Interacting withvirtual devices.
Options below are specific to the command prompt:
-h: displays the list of available options.
-r ip_address: connects to a given virtual device.
-c "command": runs the command on the selected virtual deviceand returns corresponding
values.
-f file: runs the content of the file on the selected virtualdevice and returns
corresponding values line by line.
8/20/2019 Genymotion 2.5.2 User Guide
62/75
Keyboard Shortcut
Genymotion 2.5.2 User Guide
Keyboard Shortcuts
In this section, you will find all available keyboard shortcutsfor a faster use of Genymotion and
virtual device features.
Genymotion shortcuts
Action Shortcut
Windows/LinuxShortcut
Mac OS X
Start virtual device+ +
Add virtual device+ +
Open About window+ +
Open User Guide+
Open Genymotion settings+ +
Delete virtual device+ +
Open virtual device settings+ +
Clone virtual device+ +
Reset virtual device+ +
Generate virtual device logarchive + +
8/20/2019 Genymotion 2.5.2 User Guide
63/75
Keyboard Shortcut
Genymotion 2.5.2 User Guide
Virtual device shortcuts
Category Action Shortcut
Windows/Linux
Shortcut
Mac OS X
Widgets Open Battery widget+ +
Widgets O pen GPS widget+ +
Widgets Open Camera widget+ +
Widgets Open Capture widget+ +
Widgets Open Remote Control
widget + +
Widgets Open Identifiers widget+ +
Widgets Open Network widget+ +
Widgets Open Phonewidget+ +
Capture Take screenshot+ + + +
Capture Make sc reen cast+ + + +
Capture Open screen capture
destination folder + + + +
Multi-touch Zoom in+ + +
Multi-touch Zoom out+ + +
8/20/2019 Genymotion 2.5.2 User Guide
64/75
Keyboard Shortcut
Genymotion 2.5.2 User Guide
Category Action Shortcut
Windows/Linux
Shortcut
Mac OS X
Multi-touch Tilt forth+ + +
Multi-touch Tilt back+ + +
Multi-touch Rotate clockwise + + + +
Multi-touch Rotate counterclockwise + + + +
Volume Increase volume + +
Volume Decrease volume+ +
Display Rotate screen+
Display Activate/Deactivate
Pixel Perfect + +
Display Activate full-screen+ +
Display Show/Hide widget tool-
bar + +
Display Show/Hide display
and volume tools + +
Navigation Back + +
Navigation Recent apps+
8/20/2019 Genymotion 2.5.2 User Guide
65/75
Keyboard Shortcut
Genymotion 2.5.2 User Guide
Category Action Shortcut
Windows/Linux
Shortcut
Mac OS X
Navigation Menu+ +
Navigation Home+ +
Navigation Power+
8/20/2019 Genymotion 2.5.2 User Guide
66/75
Glossary
Genymotion 2.5.2 User Guide
Glossary
A
Accelerometer
A sensor that detects motion and orientation of a device.
ADB
See Android Debug Bridge.
ADT
See Android Developer Tools.
Advanced Micro Dynamics virtualizationA set of hardwareextensions for the X86 processor architecture, designed to performrepetitivetasks normally performed by software and improve resourceuse and virtual machineperformance.
AMD-V
See Advanced Micro Dynamics Virtualization.
Android Debug Bridge
A command line utility that allows to communicate with anemulator instance or connectedAndroid device. Android Debug Bridgeis a client-server program that includes three components:
a client, a server and a service. Genymotion is compliant withAndroid Debug Bridge.
Android Developer Tools
A plugin for Eclipse IDE that provides a suite of tools fordeveloping applications on Androidplatforms.
Android ID
A 64-bit number randomly generated when the user first sets up adevice. It remains the same forthe whole lifetime of the user'sdevice. Android 4.2.2 and greater versions support multipleuseraccounts, each one having a unique Android ID.
Android SDKThe software development kit thatprovides developer tools to build, test and debugAndroidapplications, containing among others ADB, ADT and AAPT.
Android Studio
An integrated development environment from which you can developAndroid applications. It isbased on IntelliJ IDEA.
8/20/2019 Genymotion 2.5.2 User Guide
67/75
Glossary
Genymotion 2.5.2 User Guide
B
Baseband
The component in charge of a device telephony features.Genymotion emulates a baseband andallows to interact with it viathe Phone widget, an API or Genymotion Shell.
Basic Input Output System
An instruction program which checks each component duringmachine boot to adapt theoperating system to the hardwareenvironment.
Battery widget
A Genymotion feature that allows to test how your applicationreacts with different batterycharge levels and states ofcharge.
BIOS
See Basic Input Output System.
C
Cache
A buffer storage where temporary files are stored.
Camera widget
A Genymotion feature that allows to send a video stream from awebcam to the Android system.It aims at testing an Androidapplication that uses an Android built-in camera.
Capture widgetA Genymotion feature that allows to take ascreenshot or make a screencast of actionsperformed on virtualdevices.
Central Processing Unit
The functional unit of a computer that consists of one or moreprocessors and their internalstorages.
CPU
See Central Processing Unit.
8/20/2019 Genymotion 2.5.2 User Guide
68/75
Glossary
Genymotion 2.5.2 User Guide
D
Device ID/IMEI/MEID
A device unique identification number which comprises 14 digitsor hexadecimal digits and achecksum digit, complying with the GSM02.16 standard and the 3GPP2 specification. The deviceIDcorresponds to the IMEI number for GSM phones and to the MEIDnumber for CDMA phones.
E
Eclipse
An integrated development environment from which one can developvarious types ofapplications.
F
Flashable archive
A zip-compressed archive file containing a system folder.
G
Genymotion Shell
A command prompt designed to interact with Genymotion virtualdevices.
GPS widget
A Genymotion feature that allows real-time activation andmodifications of a position, accuracyand bearing of a virtualdevice.
Gradle
A build engine running on the Java platform.
H
Host-only network
A virtual network contained within the host computer. Host-onlynetwork must be enabled wheninstalling VirtualBox for Genymotion torun on your computer.
HTTP proxyAn intermediary component between a local network andthe Internet that a HTTP requestqueries to retrieve informationfrom the web.
8/20/2019 Genymotion 2.5.2 User Guide
69/75
Glossary
Genymotion 2.5.2 User Guide
I
IDE
See Integrated Development Environment.
Identifiers widgetA Genymotion feature that shows device ID andAndroid ID numbers and allows to view and editthese values at anytime, without having to reboot the virtual device.
Integrated Development Environment
An application from which one can develop applications.
Intel virtualization technology
The Intel processor’s hardware ability to divide and isolate itscomputing capacity for multiplehost virtual machines and theiroperating systems.
Intel VT-x
See Intel virtualization technology.
L
Log file
A file that records all events that occur when using anapplication.
M
Maven
A build engine running on the Java platform.
Multi-touch
The ability of a device to recognize common gestures allowing tointeract with a touch screen.
N
Network widget
A Genymotion feature that allows to test the behavior of anapplication with different networkqualities of service.
8/20/2019 Genymotion 2.5.2 User Guide
70/75
Glossary
Genymotion 2.5.2 User Guide
O
OpenGL
An application programming interface for rendering 2D and 3Dvector graphics.
Oracle VM VirtualBoxA software that virtualizes operatingsystems by using hardware resources of the host system toinstallguest systems.
P
Phone widget
A Genymotion feature that allows to test applications relying ontelephony features.
Pixel Perfect
A Genymotion feature that enables being highly precise in thedevelopment of a user interface:one pixel of a virtual device isdisplayed using one pixel of the computer screen.
Plugin
A software element that can be added to an existing applicationto extend its capabilities.
R
Remote control widget
A Genymotion feature that allows to take control of a virtualdevice from a physical device (anyphone or tablet running Froyo/API8 or greater).
S
Software Development Kit
A set of tools designed for helping developers createapplications meant to run on a specificenvironment.
V
Virtual device
An Android device preconfigured in Genymotion and run by OracleVM VirtualBox. Genymotionvirtual devices are the platforms on whichapplications are tested.
8/20/2019 Genymotion 2.5.2 User Guide
71/75
Index
Genymotion 2.5.2 User Guide
Index
A
ADB 29
Android application
Android Studio 55
Deployment 18, 36
Drag and drop 45
Eclipse 52
Android SDK tools
Custom 29
Default 29
Android Studio
JetBrains repository 53
Plugin 53
Plugin icon 53-54
Android version 22,58
B
Baseband 59
Battery
Charge level 37, 57
State of charge 37, 57
Widget 37
C
Cache 30,60
Camera
Back camera 39
Dummy webcam 39
Front camera 39
Widget 39
8/20/2019 Genymotion 2.5.2 User Guide
72/75
Index
Genymotion 2.5.2 User Guide
Capture
File location 40
Screencast 40
Screenshot 40
Settings 30
Widget 40
Compatibility
OpenGL 6
VirtualBox 6
Web browsers 7
Copy and paste 46
Credentials 15
D
Download
Genymotion 8-9, 31
VirtualBox 8-9
Drag and drop 45
E
Eclipse
Plugin 50
Update Site 50
F
Filters
Android version 22
Device model 22
G
Genymotion activation 25
Genymotion Shell 56
Command prompt 61
8/20/2019 Genymotion 2.5.2 User Guide
73/75
Index
Genymotion 2.5.2 User Guide
Virtual device commands 56
GPS
Accuracy 38, 58
Altitude 38, 57
Bearing 39, 58
Latitude 38, 57Longitude 38, 57
Widget 38
I
Identifiers
Android ID 42, 58
Device ID/IMEI/MEID 42, 58
Widget 42
L
Language 8
License 60
Expiration 25, 31
Registration 11, 31
Validation 12
License server 13
Linux
Genymotion installation 9
Logarchive location 30
Logs
Generation 30
M
Mac OS X
Genymotion installation 9Log archive location 30
Multi-touch 45
8/20/2019 Genymotion 2.5.2 User Guide
74/75
Index
Genymotion 2.5.2 User Guide
N
Navigation
Android navigation bar 34
Navigation buttons 47
Network 27
Profiles 44, 58-59
Widget 43
P
Phone
Baseband 59
Call 45, 59
SMS 45, 59
Widget 44
PixelPerfect 46
Proxy
Authentication 27
Settings 27
R
Remote control
Accelerometer 42
Touch screen 42
Wi-Fi 41
Widget 41
Rotate screen 46,58
S
Statistics 25
V
Virtual device
Clone 34
8/20/2019 Genymotion 2.5.2 User Guide
75/75
Genymotion 2.5.2 User Guide
Configure 33
Custom 23
Delete 35
Reset 34, 56
Update 47
VirtualBox
Installation 8
Networking 8-9
Settings 28
W
Widgets
Battery 37
Camera 39
Capture 40
GPS 38Identifiers 42
Network 43
Phone 44
Remote control 41
Windows
Genymotion installation 8
Log archive location 30
Vista 9
![Genymotion 2.5.2 User Guide - [PDF Document] (2024)](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/h8AAvMB+NzmkbcAAAAASUVORK5CYII=)