User Guide
Overview
Genymotion is a complete set of tools that provides a virtual environment for Android. It can be very useful for developers, testers, salesman or even gamers.
It is available for most operating systems: Windows, Linux and Mac OS X. It is as simple to install as powerful to use:
Follow the simple install process, choose one of our Android virtual devices, start it, and enjoy it!
Features
Android as its best
- OpenGL acceleration to achieve the best 3D performance
- Enable full screen option and improve your experience
- Be precise in your UI development with the "pixel perfect" functionality
Fully controllable
- Start multiple virtual device at the same time
- Manage sensors:
- Battery level / status
- GPS
- Rotation
- Camera
- Override virtual device identifiers
- Directly command virtual devices sensors with Genymotion Shell
- Fully compatible with ADB. You can control your virtual device from the host
Manage your devices
- Easy to install
- Compatible with Microsoft Windows 32/64 bits, Mac OSX 10.6+ and Linux 32/64 bits
- Configure virtual devices:
- Screen resolution
- Memory quantity
- CPU unit quantity
- Download and deploy easily the latest Genymotion virtual device
Start your virtual devices from Eclipse
- Test your applications with Genymotion
Requirements
Operating System requirements
You need one of the following system:
- Microsoft Windows XP SP3 (32 or 64 bits)
- Microsoft Windows Vista (32 or 64 bits)
- Microsoft Windows 7 (32 or 64 bits)
- Microsoft Windows 8 / 8.1 (32 or 64 bits)
- Linux Ubuntu 12.04 (32 or 64 bits)
- Linux Ubuntu 12.10 (32 or 64 bits)
- Linux Debian Wheezy (64 bits)
- Mac OS X 10.6
System requirements
- OpenGL 2.0 capable graphic card, with an up-to-date driver
- VT-x or AMD-V capable CPU, enabled in BIOS settings
- At least 2GB of RAM memory
- At least 100MB of free space on Hard Drive for Genymotion installation
A minimum of 2GB of free space is required to deploy each Genymotion virtual devices. They might need more than 8GB depending on your usage of the virtual devices and the applications you have installed.
- Internet connection (installation and updates)
- Screen resolution greater than 1024 x 768 pixels
Application requirements
- Oracle VirtualBox >= 4.2.12 (greater is better)
Genymotion Cloud requirements
- Internet Explorer >= 9 (greater is better)
- Mozilla Firefox >= 3.0
- Google Chrome >= 2.0
- Safari >= 4.0
Installation
Register
- Go to Genymotion register page
- In the signup form, fill the fields with your personal informations
- Click the "SIGN UP" button
- You will receive a validation E-mail. Click on the validation link to finish
- You will receive another E-mail, indicating that your registration is now complete
Download and Install Oracle VirtualBox
If you don't already have VirtualBox installed, read the following section.
- Windows
The easiest way to install VirtualBox is to download the Genymotion package that contains VirtualBox installerhere
- Mac OS X
Go to VirtualBox download page and get the Mac OS X .dmg file. Open the .dmg file and follow the installation steps. When finished, reboot.
- Linux
Check your repositories: almost every GNU/Linux have a package installer for VirtualBox. If not, or if you need to install a specific version, go to VirtualBox download page
Download Genymotion
- Go to official Genymotion download page
- Select the package corresponding to your system and download it
Install Genymotion
Depending of your system, follow the install process:
- Windows
- Double click on .msi installer
- Choose the installer language (the Genymotion language depends of your system language) and click the "Next" button
- Click the "Next" button again
- Change the path if needed (the default path is C:\Program Files\Genymobile\Genymotion) then click the "Next" button
- Click the "Next" button again
- Choose whether or not to create desktop icon. Then click "Next" button
- Click the "Install" button
- Click the "Finish" button
- Mac OS X
- Open the .dmg installer
- Move Genymotion and Genymotion Shell to application directory
- Linux
- In a terminal, run the following commands:
chmod +x [DOWNLOAD_PATH]/genymotion-[VERSION]_[ARCH].bin cd [DOWNLOAD_PATH] ./genymotion-[VERSION]_[ARCH].bin -d [YOUR_INSTALL_PATH]
- Run Genymotion:
cd [YOUR_INSTALL_PATH] ./genymotion
- In a terminal, run the following commands:
Quick start
- Run Genymotion
- Windows
Click the icon on your desktop
- MacOS
Click the icon from the Application directory
- Linux
Launch
[InstallationPath]/genymotion
- Windows
- The main window appears.
- And immediately, a pop-up appears and invites you to add your first virtual device.
- Click the "Yes" button.
The creation window appears.
- Click the "Connect" button.
Fill the authentication window with your Genymotion Cloud username/email address and password, then click the "Connect" button.
- Once connected, you will see all the available virtual devices.
Select a virtual device (Nexus 7 - 4.3, for example) in the list and click the "Next" button.
- Choose a new name for your virtual device and click the "Next" button.
- Your virtual device will now be downloaded and deployed.
- Click the "Finish" button to close the deployment window.
- Click the "Play" button to start your newly created virtual device.
- Enjoy.
Licensing
Genymotion licensing system
For more informations about Genymotion software usage, please visit the following page: Usage disclaimer
Licenses differences and contents
For more details about the content of each licenses and differences among licenses, please visit the following page:Licenses details
License installation
To install a license into Genymotion and use the related features (Remote Control widget, Screencast widget, ...), follow these steps:
- Run Genymotion
- Open the 'About' window
- Copy and paste your license key in the dedicated text field
- Press the 'Register' button
- If you're not already logged, a window will open and allow you to enter your credentials
- License information are sent to the Genymotion Cloud to check their validity
If your license is valid, your software will be fully unlocked and all corresponding features will be available.
If you have any problem registering your license, please, contact us using the support page
Software activation
To check your license validity and ensure nobody else is using it, you’ll have to connect periodically to the Genymotion Cloud with Genymotion.
If you don't connect for several days, then your Genymotion software will switch back to free mode.
When your license is about to expire, the Genymotion software will notify you and ask you to connect to Genymotion Cloud.
Genymotion Application
Manage window
The main Genymotion window lets you manage your virtual Genymotion devices:
![Genymotion main window](https://i-blog.csdnimg.cn/blog_migrate/451ba1b80aa5c02c0e69b1234684d657.png)
In the menu bar, you can:
- Launch the selected virtual device, using the "Play" button
- Create a new virtual device, using the "Add" button
- Open the application settings, using the "Settings" button
- Open the information window, using the "About" button
- Open the documentation, using the "Help" button
- Configure virtual machine settings (resolution, DPI, Android navigation bar, ...)
- Remove a virtual device
Virtual device creation window
When clicking the "Add" button of the main window, it will open the virtual device creation window:
![Add a new virtual device](https://i-blog.csdnimg.cn/blog_migrate/8999e20ab91377bd91cafa48468e7bcc.png)
From this window, you can choose and create virtual device from the ones available online, or locally.
If you don't see any virtual device in the list, click the "Connect" button at the bottom of the list.
Genymotion Cloud connection window
When clicking the "Connect" button, you will be prompt for your Genymotion Cloud credentials:
![genymotion-main-window.png](https://i-blog.csdnimg.cn/blog_migrate/3333cd569c3c66c2aeb51820aed4319d.png)
Application settings
General tab
![genymotion-settings-general.png](https://i-blog.csdnimg.cn/blog_migrate/4f602e26d7d8da31f9e0d9fc7a7f19be.png)
The general tab contains basic settings.
- Automatically checks for software update: enable update process at start.
- Authorize send of software statistic for the purpose of improve it: allow Genymotion to send anonymous usage statistics. This really helps us understanding how the product is used to improve it.
- Notify me when my license is about to expire: enable license notifications. Genymotion will inform you before your license expiration.
- Notify me when my activation is about to expire: enable activation notifications. Genymotion will inform when you will need to renew your software activation. You must connect to the Genymotion Cloud to refresh your software activation.
- Remember my Genymotion Cloud credentials: enable quick connections. You have to set your username and password in the corresponding fields. Note that password will not be stored in plain text but in an encrypted form.
Network tab
![genymotion-settings-network.png](https://i-blog.csdnimg.cn/blog_migrate/338e507c9ad46895c1fbb1e2e5de7855.png)
Change the network settings to fit your Internet access.
- Use HTTP Proxy: tell Genymotion to use a proxy to connect to Genymotion Cloud. You have to set your proxy address and port in the corresponding fields. Only HTTP proxy works. NTLM or Socks proxy won’t.
- Use authentication: enable proxy authentication. You must enter your username and password in the corresponding fields.
VirtualBox tab
![genymotion-settings-virtualbox.png](https://i-blog.csdnimg.cn/blog_migrate/113828a2424c4360b436145e35cac0fb.png)
Configure virtual devices storage path.
- Virtual device path: set where to store Genymotion virtual devices. It must be an absolute path.
ADB tab
![genymotion-settings-adb.png](https://i-blog.csdnimg.cn/blog_migrate/ca97bea462a5fa59bc3122cfd565369f.png)
Configure Genymotion to use ADB
By default, Genymotion use its own ADB utility. But it is possible to use your own ADB configuration (from Android SDK).
- Use Genymotion tools (default): work with ADB tool provided with Genymotion.
- Use custom Android tools: set the storage path of an installed Android SDK, to use tools provided by this SDK. For more information on how to install your own Android SDK, follow this tutorial.
Misc tab
![genymotion-settings-misc.png](https://i-blog.csdnimg.cn/blog_migrate/1e6bcd2caa38d920c69c6e9201d5e1c1.png)
Set various options.
- Capture location: you can modify the storage path for screenshots and video.
- Cache usage: to save space on your workstation, you can remove temporary downloaded files and logs withClear cache button.
Virtual device management
![Genymotion virtual device list](https://i-blog.csdnimg.cn/blog_migrate/e7af931e55f2dfd51dd180d3a8d77ce2.png)
From the virtual devices list, you can:
Configure: Modify selected virtual device settings.
Clone: Copy this virtual device to a new one.
Factory Reset: Restore selected virtual device to its initial state.
Delete: Delete selected virtual device.
Virtual device settings
![Genymotion virtual device settings](https://i-blog.csdnimg.cn/blog_migrate/ed716573c98b9c10eebb65e30283d00e.png)
In this window, you can configure virtual device settings such as its screen size, density, navigation bar, ...
- Predefined screen size: set screen size and density from a predefined list.
- Custom screen size: set a custom screen size and density. Warning, you may experience issues when using custom density and screen size values.
- Run virtual device in full screen mode: if checked, the virtual device will start in fullscreen mode and its screen size will be adjusted to your screen size.
- Show Android navigation bar: if checked, the virtual device will start with Android navigation bar enabled (with 3 Android buttons: Back, Home and Recent applications)
- Use virtual keyboard for text input: if checked, the virtual device will use either the virtual keyboard or your computer keyboard when focusing on an input area. If not checked, then your computer keyboard will be used.
Virtual device factory reset
When you deploy a new virtual device, at the end of the deployment, a snapshot is created. At any time you can restore your virtual device to its initial state just by using the "Factory Reset" button.
Warning: All installed applications, system patches, modified settings and data will be lost.Virtual device starting
When you run a virtual device from the main window of Genymotion, there are three steps:
- Set network parameters and rendering parameters.
- Check if CPU virtualization (VT-X on Intel processors and AMD-V on AMD processors) is enabled. If not, then your virtual device doesn't support the management of several processors. In this case, the number of processors will be set to 1 automatically.
- Check if the Genymotion version of your virtual device is compatible with the Genymotion version software.
If all these steps passed with success then your Genymotion virtual device is ready to use.
Virtual device update
If Genymotion is up-to-date but a new version of virtual devices has been released, we recommend that you update some or all of your virtual devices.
When starting a virtual device, a popup window indicates that a newer version is available. Click Update.
During the update process, the wizard introduces some of the new features.
Note that when you upgrade a virtual device, the following items will not be lost:
- User settings in Android
- System packages that you have deployed via drag'n drop
- Applications that you have installed, and their data
Genymotion virtual devices
Virtual device execution
![Genymotion Player ready](https://i-blog.csdnimg.cn/blog_migrate/08fd8bf4686545329be82e77a53ef5ed.png)
This is the window where the virtual device is running and where you can interact with it
- Genymotion widget buttons
- Genymotion widget Battery button (CTRL + 1)
- Genymotion widget GPS button (CTRL + 2)
- Genymotion widget Camera button (CTRL + 3)
- Genymotion widget Screencast button (CTRL + 4)
- Genymotion widget Remote Control button (CTRL + 5)
- Genymotion widget Identifier button (CTRL + 6)
- Genymotion Screencast buttons
- Take a screenshot (CTRL + SHIFT + S)
- Record a video (CTRL + SHIFT + V)
- Browse recorded media files (CTRL + SHIFT + E)
- Control buttons
- Virtual device rotation button (CTRL + F11)
- Pixel perfect button (CTRL + R)
- Volume up button (CTRL + +)
- Volume down button (CTRL + -)
- Back button (CTRL + BACKSPACE)
- Recent applications button(CTRL + SPACE)
- Menu button (CTRL + M)
- Home button (CTRL + HOME)
- Power button (CTRL + ESCAP)
Multi-touch Gestures
Because in most cases, virtual devices are controlled with mouse and keyboard, some shortcuts have been implemented to help simulate common gestures:
- Right click + Move mouse to the Left: Zoom In
- Right click + Move mouse to the Right: Zoom Out
- Right click + Move mouse Up: Tilt Forth
- Right click + Move mouse Down: Tilt Back
- SHIFT + Right click + Move mouse to the Left: Counterclockwise Rotation
- SHIFT + Right click + Move mouse to the Right: Clockwise Rotation
Note: on Apple OS X, you can replace Right click by using CTRL + click
Drag & drop
Genymotion virtual devices support files drag&drop from computer to the device. Behaviour is different depending on the file type:
- Regular files: regulars files will be pushed to
/sdcard/Download
.They can be accessed by the the file explorer provided into the virtual device.
- Android applications: APK will be installed on the virtual device.
If the same application already exists with another signature, you will have the choice to override the existing application.
- Flashable archives: zip archives detected as flashable (containing a
/system
folder) will be flash on the device.Such archives may damage your Genymotion virtual device. It is recommended to reboot your virtual device after flashing an archive.
Note: drag&drop requires ADB configured to work. Click here to learn how to configure ADB with Genymotion.
Copy/past
The clipboard is shared between your computer and Genymotion. Thus, you can easily copy and paste text from your computer to Genymotion, and reciprocally.
Pixel perfect!
If you want to be precise in your UI development, you can use the "pixel perfect" button.
- One click on the button will enable pixel-perfect mode. Each pixel of the device will be displayed using only one pixel of your monitor, allowing you to ensure every pixel of your application is really as it should be.
- Another click will exit the pixel-perfect mode.
Note: if the device screen size is bigger than your monitor size, Genymotion window will be maximized and you will be able to use scrollbars to move into the device screen.
Battery widget
![Genymotion battery widget](https://i-blog.csdnimg.cn/blog_migrate/b77e6b11a63b9db5690d6c7355803014.png)
The battery widget allows modifications of the battery level, power status and power mode of the Genymotion virtual device.
First, open the widget using the corresponding panel button
- Activate the simulated battery mode
By default, the Genymotion virtual device simulates the same battery as the one present in your computer. This button activate the simulation of a battery with custom values that you can adjust to test your application.
When your computer does not have a battery (desktop computer for example), the simulated is automatically activated.
- Modify the battery power level
When the simulated battery is activated, you can specify the Genymotion current battery level using the slider or by entering manually the value in the corresponding field.
- Modify the status
When the simulated battery is activated, you can also modify the current status of the battery with the corresponding button:
- Charging: the AC is plugged in and the battery is currently in charging state
- Discharging: the AC is unplugged and the battery is currently in discharging state
GPS widget
![Genymotion GPS widget](https://i-blog.csdnimg.cn/blog_migrate/680c8b464125067457d7b143cbca8364.png)
The GPS widget allows *real time* activation and modifications of the position,accuracy and orientation.
- Activate the GPS
When you activate the GPS with the corresponding button, you enable the reception of generated GPS frames in the Genymotion virtual device. When it is not activated, the GPS is not able to refresh the position, and the last known location is used.
- Modify position
Using the latitude and longitude field, you can specify the current position you want to simulated. They must be specified in degrees: the latitude from -90.0° to 90.0°, and the longitude from -180 to 180°
- Modify the altitude
You can specify a custom altitude from -10000 m to 10000 m
- Modify accuracy
You can specify a custom accuracy value using the slider or by entering the desired value from 0 to 200 m.
- Modify bearing
You can modify the bearing using the corresponding dial, or by entering the desired value form 0 to 359,99°
Note than many applications do not rely on the GPS orientation, but use the device accelerometer or gyroscope to determine the bearing of the device, which are not yet supported.
Camera widget
![Genymotion Camera widget](https://i-blog.csdnimg.cn/blog_migrate/2c6ddda525c77fc82e2c19936235f562.png)
The Camera widget allows you to send a video stream to the Android system from a Genymotion virtual device.
With this feature you can test your Android application that requires the use of Android device builtin camera (eg, the development of an application such as a camera or video editing application type, ...).
The video stream can come from a dummy camera or a real physical webcam connected (or integrated) in your workstation. So you can send a real-time streaming.
- Activate the Camera widget
When you activate the widget with the corresponding button, the Genymotion software tries to detect the available webcam on your workstation.
- Front and rear cameras:
- Front camera allows to send data to the Android front camera
- Back camera allows to send 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
- Preview:
The preview allows you to see the video stream which will be sent to the Android system, as the front or as the back camera.
With this preview, you know if webcam is operational.
Screencast widget
![Genymotion screencast widget](https://i-blog.csdnimg.cn/blog_migrate/93a9c33c7d5febeda628497677d9ffd0.png)
The Screencast widget allows you to take a screenshot or to record a video (with sound capture) of virtual devices.
It is very convenient to broadcast images or videos of your applications on web sites (Youtube, Google Play, ...).
All screenshots and recordings are stored in your home directory, in a folder named with your virtual device name. You can change this default folder in the configuration panel.
- Screenshot button
When you press this button, a screenshot of your virtual device is stored in configured folder.
The shortcut for this action is CTRL-SHIFT-S. - Video button
When you press this button, a video of your virtual device starts recording. Press this button again to stop recording.
If your virtual device emits sound then it will be captured with the video.
The shortcut for this action is CTRL-SHIFT-V. - Browse button
When you press this button, a file explorer opens to allow you to directly access your screenshots and recorded videos.
The shortcut for this action is CTRL-SHIFT-E.
Note: All screencast features are accessible via shortcuts even if Screencast widget is not displayed.
Remote control widget
![Genymotion remote control widget screenshot](https://i-blog.csdnimg.cn/blog_migrate/db38a3a7584dbe8512c62173f5bbae9c.png)
The remote control widget allows you to take control of Genymotion virtual devices with your real device (any phone or tablet running API 8/Froyo or greater). This widget works with a specific Android application that runs on your device and forwards touch inputs and accelerometer values to Genymotion.
As a result, you will be able to test the behavior of your application as if it was running in your hands.
- Activate the Remote control widget
When activating the widget with the corresponding button, Genymotion tries to detect any connected Android devices.
- Select the device and start
Select your device in the list box, then click the "Start" button. If the device is connected to ADB and not visible in the list, then restart the widget.
- Enable options
You can toggle the desired options:
- Display preview.
Allows you to preview your Genymotion screen on your physical device. - Touch input.
Allows your physical device to send touch events to Genymotion. - Accelerometer.
Allows your physical device to send accelerometer events to Genymotion
- Display preview.
- You must install ADB to use this feature.
- The widget automatically stops if you disconnect your device without stopping the widget; you can resume the remote control widget reconnecting the device to ADB and clicking the "Start" button.
- Errors will appear between the select box and the options. Moving the mouse on the error will display the details.
Identifier widget
![Genymotion Identifier widget screenshot](https://i-blog.csdnimg.cn/blog_migrate/e1ab698b1a8999e5c464e011c0384a1c.png)
Genymotion identifier widget shows Device ID and Android ID numbers. You can see and edit these values at runtime, without having to reboot your virtual device.
Android ID
An Android ID is a 64-bit number (as a 16 hex digits string) that is randomly generated when the user first sets up the device and should remain constant for the whole lifetime of user's device.
Android 4.2.2 and newer versions support multiple user accounts, each one having a unique Android ID.
Button![Android ID randomize button](https://i-blog.csdnimg.cn/blog_migrate/769446b4ac0d3ec1705612a2bbb717b9.png)
Valid characters for setting Android ID are:
- 16 hexadecimal digits long (mandatory).
Note: it is NOT allowed to set an empty Android ID.
Device ID / IMEI / MEID
By default, a new virtual device is deployed with a default Device ID of 00 000000 000000 0
.
Button on the right of input text box generates a random identifier for you. As IMEI or MEID number are used as Device ID, Genymotion will generate valid numbers, according to GSM 02.16 standard and 3GPP2 specification (14 digits or hex-digits + a checksum digit).
Valid characters for setting Device ID / IMEI / MEID are:
- dot (.)
- letters (a-z, A-Z)
- digits (0-9)
- dash (-) and underscore (_)
Note that it is allowed to set an empty Device ID.
Eclipse Plugin
One of the most interesting feature of Genymotion is that you can test your application developed with Eclipse IDE. It uses ADB to connect to any active Genymotion virtual devices and then push your application.
Plugin installation
There are two ways to install the plugin:
- Update Site method
- Start Eclipse
- Go to the "Help/Install New Software..." menu
- In the new opened window, click the "Add..." button (on top right of the window)
- Fill the fields with these items and then validate:
- Name:
Genymobile
- Location:
http://plugins.genymotion.com/eclipse
- Name:
- You should see a tree with Genymobile < Genymotion names
- Check those entries and then, click "Next"
- Read and Accept the license
- Eclipse will warn you that the plugin is not signed, accept it even though
- To finish the installation, restart Eclipse
- After Eclipse's restart, you will see a new button on the toolbar:
- Finally, you can check install: Go to "Help/About" menu, click the "Installation Details" button. In the "Plugin" column Genymotion should appear
- Manual method
- Ensure Eclipse is closed
- Download the plugin on Genymotion official download page
- Depending of you system, follow the steps:
- Windows
- If you have administrator rights, put the jar archive in plugins directory of your Eclipse install
- Without administrator rights, put the jar archive in plugins directory of your Local Settings\Eclipse
- Mac OS X
- With administrator rights, put the jar archive in plugins directory of your Eclipse install
- Linux
- If you have administrator rights, put the jar archive in plugins directory of your Eclipse install
- Without administrator rights, put the jar archive in plugins directory of your
/home/[user]/Eclipse
- Windows
Plugin usage
Click the button in Eclipse toolbar to open the plugin
First start
- You will need to set path to Genymotion installation directory (given default path only works for standard's Genymotion installation):
- Windows:
C:\Program Files\Genymobile\Genymotion
- Mac OS X:
/Applications/Genymotion.app
- Linux:
/home/[user]/genymotion
- Windows:
- Click the "Apply" button and then "OK"
- Click again the
button to prompt the main plugin window
Actions
In the plugin main window, you can do the following steps:
- Start a Genymotion virtual device
- Create a new Genymotion virtual device
- Refresh the list of Genymotion virtual device
"Create" action will automatically start the Genymotion creation wizard
virtual device states
In the "status" column of the main window can take the following status:
- Off: The virtual device is in Off state
- Paused: The virtual device has been started, and then paused : restart action will get back at exactly same state
- On: The virtual device is on, but not connected to ADB. It means that you cannot choose this virtual device in the "Android Device Chooser" window of ADT plug-in
Use Genymotion to run Android application
- First, click the
button and start the virtual device you want to use.
- Close the Genymotion main window
- In your application project, right click and chose "Run as Android application"
- The "Android Devices Chooser" opens
- Click on the Genymotion virtual device you started/created
Genymotion-VMNAME-@IP:PORT
Where:VMNAME
is the virtual device name, as define in Genymotion@IP:PORT
are the device address and port (assigned by ADB)
After a reboot or an unexpected halt of a Genymotion virtual device, its displayed name in the "Android Devices Chooser" window can became unrelated. Close and re-open the Genymotion plugin to resolve this
Error handling
While Genymotion plugin window is open, errors are printed in Eclipse console.
IntelliJ Plugin
As for Eclipse, we provide a plugin for IntelliJ IDE (Like Android Studio, or IDEA).
With it, you can easily test your applications. It uses ADB to connect to any running Genymotion virtual device and then push your application.
Plugin installation
There are two ways to install the plugin:
- JetBrains repositories method
- Start your IDE
- Go to the "File/Settings" menu
- In the new opened window, select the "Plugins" section and then click the "Browse repositories..." button (on the bottom right)
- In the list, click on Genymotion and click the "Download and install" button (on the upper-left corner)
- Click the "Yes" button to begin
- Click the "Close" button to leave the browse repository window
- Click the "OK" button to leave the settings window
- IntelliJ asks for restart. Accept by clicking the "Restart" button
- Manual method
- Download the plugin on Genymotion official download page
- Start your IDE
- Go to the "File/Settings" menu
- In the new opened window, select the "Plugins" section and then click the "Install plugin from disk..." button (on the bottom right)
- Select the
genymotion-IDEA-plugin.jar
file - Click the "OK" button
- The IDE asks for restart, accept by clicking the "Restart" button
Plugin usage
Click the button in IntelliJ toolbar to open the plugin
First start
- You will need to set path to Genymotion installation directory (given default path only works for a standard install):
- Windows:
C:\Program Files\Genymobile\Genymotion
- Mac OS X:
/Applications/Genymotion.app
- Linux:
/home/[user]/genymotion
- Windows:
- Click the "OK" button
- Click the
button again to open the main plugin window
Actions
In the plugin main window, you can do the following actions:
- Start a Genymotion virtual device
- Create a new Genymotion virtual device
- Refresh the list of Genymotion virtual device
"Create" action will automatically start the Genymotion creation wizard.
virtual device states
The "status" column of the main window can take the following values:
- Off: The virtual device is Off
- Paused: The virtual device has been started, and then paused: restart action will get back at exactly same state
- On: The virtual device is on, but not connected to ADB. It means that you cannot choose this virtual device in the "Android Device Chooser" window of ADT plug-in
Use Genymotion to run Android application
- First, click the
button and start the virtual device you want to use.
- Close the Genymotion main window
- In your application project, right click and chose "Run as Android application"
- The "Android Devices Chooser" opens
- Click on the Genymotion virtual device you started/created
Genymotion-VMNAME-@IP:PORT
Where:VMNAME
is the virtual device name, as defined in Genymotion@IP:PORT
are the device address and port (assigned by ADB)
After a reboot or an unexpected halt of a Genymotion virtual device, its displayed name in the "Android Devices Chooser" may become not relevant. Close and re-open the Genymotion plugin to solve it.
Error handling
While Genymotion plugin window is open, errors are printed in IntelliJ console.
Genymotion Shell
Genymotion provides a shell that enables you to script the modification of sensor states.
Command line options
-h
: print help-r ip_address
: connect to specific Genymotion virtual device-c "command"
: execute the given command in Genymotion Shell environment and return-f file
: execute the content of the file. Each command per line
Available commands
battery getmode
Get the current battery mode of the selected virtual device. The mode can only be:host
: The virtual battery reflect the host battery (if exists)manual
: In this mode, you can set the level and status battery values
battery setmode
Set the battery mode. The mode can only be:host
: The virtual battery reflect the host battery (if exists)manual
: In this mode, you can set the level and status battery values
battery getlevel
Get the current battery amount of power. The value can only be between 0% and 100%.
If the battery mode is "host", the returned value is the host value.battery setlevel
Set the current battery amount of power. The value can only be between 0% and 100%.
Set the battery level force the "manual" mode: if the last mode was "host", then it's turned to "manual"battery getstatus
Get the current battery status. There are 4 possible status:Discharging
: The power supply is disconnected and the battery is discharging.Charging
: The power supply is connected and the battery is charging.Full
: The battery is full.Unknown
: Sometimes, the battery status cannot be established, it happens when there is no host battery.
battery setstatus
Set the current battery status. There are 4 possible status:Discharging
: The power supply is disconnected and the battery is discharging.Charging
: The power supply is connected and the battery is charging.Full
: The battery is full.Unknown
: Sometimes, the battery status cannot be established, it happens when there is no host battery.
devices list
List available Genymotion virtual devices and provides details like current states or IP address.devices ping
Send a ping message to check if virtual device if respondingdevices refresh
Refresh Genymotion virtual device list. Use it to keep the list up-to-date.devices select
Select the Genymotion virtual device you want to interact with.devices show
List available Genymotion virtual devices and provides details like current states or IP addressdevices factoryreset
Factory reset virtual device (add keywordforce
at the end to avoid warning message about data loss)
gps activate
Activate the GPS sensor (if not already activated)gps desactivate
Desactivate the GPS sensor (if activated)gps getlatitude
Return current latitude (if GPS is activated AND already has a latitude) or 0gps setlatitude
Set latitude (and activate GPS if not already activated)gps getlongitude
Return current longitude (if GPS is activated AND already has a longitude) or 0gps setlongitude
Set longitude (and activate GPS if not already activated)gps getaltitude
Return current altitude (if GPS is activated AND already has a altitude) or 0gps setaltitude
Set altitude (and activate GPS if not already activated)gps getaccuracy
Return current accuracy in meters (if GPS is activated AND already has a accuracy) or 0gps setaccuracy
Set accuracy (and activate GPS if not already activated)gps getorientation
Return current orientation in degrees (if GPS is activated AND already has a orientation) or 0gps setorientation
Set orientation (and activate GPS if not already activated)
rotation setangle
Set the rotation angle of the virtual device.
genymotion capabilities
Get Genymotion capabilities (gps, webcam, remote-control, ...) of selected virtual device.genymotion clearcache
Clear temporary downloaded files and logs.genymotion version
Get Genymotion version of selected virtual device.genymotion license
Get Genymotion license (type, validity, ...).
android version
Get Android version of selected virtual device.android getandroidid
Get Android ID of selected virtual device (available only with Indie or Business license).android setandroidid
Set Android ID of selected virtual device (available only with Indie or Business license).
Warning: if several users exist on the Android system, Android ID will only be set for the first user, not for all.
Two kind of values are accepted:random
: generate a random Android ID.- custom value (must be 16 hexadecimal digits long).
android getdeviceid
Get Device ID (IMEI/MEID number) of selected virtual device (available only with Indie or Business license).android setdeviceid
Set Device ID (IMEI/MEID number) of selected virtual device (available only with Indie or Business license).
Three kind of values are accepted:none
: set an empty Device ID.random
: generate a random Device ID.- custom value (alphanumeric characters, point, dash, underscore).
build number
Get Genymotion Shell build numberhelp
Prompt the help.pause
Pause execution (in number of seconds).version
Get Genymotion Shell version.exit
orquit
Close Genymotion Shell.
Install ADB
Android Debug Bridge (adb) is a versatile command line tool that lets you communicate with an emulator instance or connected Android-powered device. It is a client-server program that includes three components: a client, a server and a service
How to install your own ADB tool and configure Genymotion to use it:
- Download the Android Developer tools (ADT)
- Unzip / untar the archive in the path of your choice.
- Start Genymotion and open the settings panel.
- Go to the tab ADB.
- Choose the option: Use custom Android tools.
- Set the ADB path like the following example:
adt-bundle\sdk
Note that :- The field will stay red until the provided path is valid
- "adt-bundle\sdk\platform-tools" is not a valid value.
- Click the "OK" button
Every Genymotion devices will now be automatically connected to ADB at start.