Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents
maxLevel5
minLevel2

Overview

Genymotion Desktop provides a library of Android virtual machines that run in Oracle's VirtualBox. It is an alternative to the Android SDK's emulators. Genymotion is faster than the Android SDK's ARM-based emulators and more reliable than x86 emulators that use Intel's HAXM technology.

Genymotion is free for personal use, however you can purchase a license for commercial use.

Compatibility and Download

Genymotion support is available for Titanium CLI 3.3.0 and later, Titanium SDK 3.3.0 and later, and Studio 3.3.0 and later.

...

You will need to register for a Genymotion Cloud account. For an updated list of requirements, see Genymotion User Guide: Requirements .

Oracle VirtualBox

Genymotion requires Oracle VirtualBox. If you do not have VirtualBox installed, you can either download a Genymotion installers that includes VirtualBox (recommended) or manually install it.

...

Note

If you have Intel Hardware Accelerated Execution Manager (HAXM) for Android installed, you may not be able to run VirtualBox. Previously, there have been conflicts with HAXM and VirtualBox.

Genymotion Cloud Account

In order to download Genymotion and Genymotion virtual devices, you will need a Genymotion Cloud account. To sign up for an account, visit https://www.genymotion.com/account/login/ . You will need to verify your e-mail address before downloading files.

Section
Column
width66px

Column

Download the appropriate Genymotion installer from https://cloudwww.genymotion.com/page/launchpad/download/. You will need to be logged into your Genymotion Cloud account to download.

 

Installation

Mac OS X

  1. Download the Mac OS X installer (DMG file) from Genymotion.
  2. Open the installer to launch it.
  3. Drag the Genymotion.app and Genymotion Shell.app icons to the Applications folder.
  4. Launch Genymotion.app from the Applications folder.
  5. The Genymotion application starts. A dialog prompts you to "Add a first virtual device". Click Yes.
  6. In order to add a virtual device, you need to connect to the Genymotion Cloud service. Click Connect.
  7. You are prompted to enter your Genymotion Cloud account credentials. Input your credentials, then click Connect.
  8. After your account has been verified, select a device and click Next.
  9. Optional: change the name of the device. Click Next.
  10. Click Finish after the download completes or click Add to download more virtual devices.

Windows

  1. Download the Windows installer (EXE file) from Genymotion.
  2. Double-click the installer to launch it.
  3. Choose a language and click OK.
  4. Click Next to accept the defaults, then click Install to start the installation process.
  5. After Genymotion installs and if you chose to use the ready-to-run Genymotion installer, the VirtualBox installer starts.
  6. Click Next to accepts the defaults, then click Install to start the installation process.
  7. After the VirtualBox installer completes, uncheck to start VirtualBox, then click Finish.
  8. The VirtualBox installer disappears and returns to the Genymotion installer. Leave the Launch Genymotion option checked, then click Finish.
  9. The Genymotion application starts. A dialog prompts you to "Add a first virtual device". Click Yes.
  10. In order to add a virtual device, you need to connect to the Genymotion Cloud service. Click Connect.
  11. You are prompted to enter your Genymotion Cloud account credentials. Input your credentials, then click Connect.
  12. After your account has been verified, select a device and click Next.
  13. Optionally change the name of the device. Click Next.
  14. Click Finish after the download completes or click Add to download more virtual devices.

Configuring Genymotion

Titanium CLI

To enable support for Genymotion with the Titanium toolchain, you need to configure the Titanium CLI. If you have not modified the default installation of VirtualBox and Genymotion, you only need to set the genymotion.enabled value to true with the appc ti config command. If you are using Studio, restart Studio after updating the CLI configuration.

...

CLI OptionDescriptionDefaults by OS
genymotion.homePath to Genymotion virtual devices
  • Mac OS X: /Users/<user>/.Genymobile/Genymotion/deployed/
  • Windows: C:\Users\<user>\AppData\Local\Genymobile\Genymotion\deployed\
genymotion.pathPath to Genymotion
  • Mac OS X: /Applications/Genymotion.app
  • Windows: C:\Program Files\Genymobile\Genymotion
genymotion.executables.genymotionPath to Genymotion genymotion executable
  • Mac OS X: /Applications/Genymotion.app /Contents/MacOS/genymotion
  • Windows: C:\Program Files\Genymobile\Genymotion\genymotion.exe
genymotion.executables.playerPath to Genymotion player executable
  • Mac OS X: /Applications/Genymotion.app/Contents/MacOS/player.app/Contents/MacOS/player
    • Before 2.6.0: /Applications/Genymotion.app/Contents/MacOS/player
  • Windows: C:\Program Files\Genymobile\Genymotion\player.exe
genymotion.executables.vboxmanagePath to VirtualBox vboxmange executable
  • Mac OS X: /usr/bin/vboxmanage
  • Windows: C:\Program Files\Oracle\VirtualBox\VboxManage.exe

Studio

Studio uses the configuration settings from the Titanium CLI to support Genymotion. In case the Titanium CLI is unable to detect the settings, you may override these settings in the Preferences dialog.

  1. Open Preferences:
    1. For Mac OS X systems, from the menu, select Appcelerator Studio > Preferences.
    2. For Windows systems, from the menu, select Windows Preferences.
  2. In Preferences, navigate to Studio >  Platforms > Android.
  3. In the Genymotion section, update the paths to the executables as needed.

Using Genymotion

Launch a Genymotion Virtual Device from the CLI

To launch an Android application on a Genymotion virtual device, run the following CLI command:

...

Where  <GENYMOTION_AVD_NAME> is the name given to the Genymotion virtual device when you downloaded it. To get a complete list of Android virtual devices, run the the appc ti info -t android command. The Genymotion devices are listed at the end right before any warning messages.

Launch a Genymotion Virtual Device from Studio

Genymotion virtual devices are listed under the same drop-down menu as your Android virtual devices. Follow the same procedure to launch a Genymotion emulator as you would an Android emulator.

...

In the screen shot below, there are three virtual devices to choose: a user-created Android virtual device, a Genymotion virtual device and an Android virtual device created by the Titanium SDK.

Troubleshooting

I cannot see a list of virtual devices under the Target drop-down list

  1. In the tiapp.xml file of the application you want to run, check to make sure the Titanium SDK is version 3.2.0 or greater.
  2. Double-check your Studio configuration settings in Preferences.
    1. For Mac OS X systems, from the menu, select Appcelerator Studio > Preferences.
    2. For Windows systems, from the menu, select Windows > Preferences.
    3. Navigate to Studio >  Platforms > Android.
  3. Restart adb, then restart Studio. To restart adb, from a terminal, run: 

    Code Block
    adb kill-server
    adb start-server

Failed to start daemon

When building an application, if the following error(s) is reported:

...

Note that if you restart your computer, this setting may not persist in Genymotion and you will need to set the Android SDK path again.

Further Reading

Genymotion User Guide

Genymotion FAQ

...