Run your Apache Cordova app on Android

  • Article

There are many options for running your apps built using Visual Studio Tools for Apache Cordova on Android. From Visual Studio, you can run and debug Android apps on the emulators and devices including the Apache Ripple simulator (discussed in a separate article) and the Visual Studio Emulator for Android.

Visual Studio Emulator for Android

Here’s how to run your app on the Visual Studio Emulator for Android. For system requirements, see System Requirements for the Visual Studio Emulator for Android.

Important: The Visual Studio Emulator for Android is only available in Visual Studio 2015.

To run your app on the emulator

  1. Make sure that Hyper-V is enabled on your PC. Your PC must meet the system requirements for the Visual Studio Emulator for Android.

    Important: The emulator is not supported in a virtualized environment.

  2. With your app open in Visual Studio, choose Android from the Solution Platforms list.

    If you don’t see this list, choose Solution Platforms from the Add/Remove Buttons list to display it.

  3. Choose one of the emulators, such as VS Emulator 5” KitKat (4.4) XHDPI Phone.

  4. Press F5 to start the app. Visual Studio starts the emulator and runs the app.

Troubleshooting? Let's fix it

If you have trouble deploying to Android emulators or devices, see Resolve Android build and deployment errors.

Google Android Emulator

Before you run your app on the Google Android emulator in Visual Studio, use the Android Virtual Device (AVD) Manager to create an emulator configuration, and then start the emulator from the AVD Manager. The following steps show how to do this. For more information, see the AVD Manager documentation.

To create an instance of the emulator

  1. Open the AVD Manager. To do this from a command line, go the location of the SDK and type android avd. On Windows, the AVD Manager.exe is installed by default in the following location: C:\Program Files (x86)\Android\android-sdk.

  2. In the AVD Manager, choose Create.

    Creating an Android emulator-1

  3. Configure the properties for the new emulator. The required properties are AVD Name, Device, Target, CPU/ABI, and Skin. Target represents an installed version of the Android SDK version (API set). Set this property to a value such as API Level 22.

    Tip: You may need to install more Android images using the Android SDK Manager. If you have trouble installing components, run the SDK Manager as an Administrator.

    Creating an Android emulator-2

    If you already installed the high-performance HAXM driver described in the next section and chose an Intel CPU, select the Use Host GPU check box in Emulation Options (not shown for ARM).

    Important: To use the high-performance emulator, you must also choose an Intel processor in the CPU/ABI section of the AVD dialog box.

  4. Choose OK to close the configuration dialog box, and then choose OK again in the dialog box that shows all the emulator settings.

  5. In the AVD Manager, select the new emulator, and then choose Start.

To run the app on the emulator

  1. With your app open in Visual Studio, choose Android from the Solution Platforms list. (If you don’t see this option, first choose Solution Platforms from the Add/Remove Buttons list.)

  2. In the device list, choose Google Android Emulator.

    Deploying to the Android emulator

  3. Press F5 to start the app, or Shift+F5 to start the app without debugging.

    Android 4.4 is required to attach the debugger. Otherwise, the app will run without debugging.

    Tip: If you get an error that indicates you need to install a new version of the Android SDK, use the Android SDK Manager to install it. On Windows, you can open SDK Manager by typing the following command on a command line: android sdk.

    Visual Studio deploys the app to the Android emulator that is currently running. If no emulator is running, Visual Studio starts the last emulator that was created using the AVD Manager, and then deploys the app.

    If you want to debug your app against Android versions 4.1.2-4.3, see the information about the jsHybugger plugin in the article Debug Your App Built with Visual Studio Tools for Apache Cordova.

Troubleshooting? Let's fix it

If you have trouble deploying to Android emulators or devices, see Resolve Android build and deployment errors.

Configure a high-performance Google x86 emulator

If you have a PC with an Intel processor, you can improve the performance of the Google Android emulator. To configure a high-performance emulator:

  1. Disable Hyper-V. You can do this from Control Panel or from a command line, as described in the following procedures.

    Caution: Disabling Hyper-V will prevent you from using the Visual Studio Emulator for Android and the Windows Phone emulator. However, you can still deploy to a Windows Phone device while Hyper-V is disabled.

  2. Install the high-performance Intel Hardware Accelerated Execution Manager (HAXM) driver, if it isn’t already installed. (More information about the HAXM driver)

  3. Configure the Google Android emulator to use hardware acceleration.

To disable Hyper-V in Control Panel

  1. In the Control Panel, choose Programs and Features, and then choose Turn Windows features on or off.

  2. Clear the check box for Hyper-V.

    Disabling Hyper-V

  3. Reboot your PC. Now you can install the HAXM driver.

    Alternatively, you can configure Windows to start with Hyper-V automatically enabled or disabled using the command line.

To disable Hyper-V using the command line

  1. Open an elevated command prompt (with administrative credentials), and type:

    bcdedit /set hypervisorlaunchtype off

    Caution: The bcdedit commands can prevent your system from booting if not executed correctly; be careful when using these commands.

    If you’re adding this command to a shell script, use the following instead:

    bcdedit /set hypervisorlaunchtype off
shutdown /r

  2. Reboot your PC. If you want to re-enable Hyper-V later, use the following command, and then reboot your PC:

    bcdedit /set hypervisorlaunchtype auto

    If you’re using the Genymotion emulator, you can skip this procedure. For more information, see Genymotion emulator.

To install the high-performance HAXM driver (Google Android emulator only)

  1. After disabling Hyper-V and rebooting, open the Android SDK Manager. To do this from a command line, go to the location of the SDK and type android. On Windows, the Android SDK Manager.exe is installed in the following location: C:\Program Files (x86)\Android\android-sdk or C:\Users\yourusername\AppData\Local\Android\android-sdk.

  2. In the Android SDK Manager, look under the Extras folder for the Intel x86 Emulator Accelerator (HAXM Installer). If the status column shows that it isn’t installed, select its check box, and then choose Install Packages.

    Installing the HAXM driver

    This downloads the HAXM driver.

  3. Install the driver by going to sdk-path\extras\intel\Hardware_Accelerated_Execution_Manager and running intelhaxm-android.exe.

    Tip: If the “intel” portion of the path isn’t present, the driver was not downloaded.

    Now you can configure an emulator to use the driver. When you create or edit an emulator, you must use an Intel CPU and select the Use Host GPU option. For more information, see the preceding section.

Troubleshooting? Let's fix it

If you have errors installing or using the HAXM driver, see Resolving issues with the HAXM driver.

Genymotion emulator

The Genymotion emulator is a popular alternative to the Android emulator that is included with the Android SDK. Follow Genymotion's instructions to install the emulator. Here are a few tips for getting started with the emulator:

  • If you have trouble starting the emulator from a remote connection, try starting it locally, and then reconnect remotely if needed. The emulator requires OpenGL for rendering, and this may result in a conflict when starting the emulator.

  • You need a video card and video card drivers that support OpenGL. You may receive messages that indicate this. (If you connect to your PC remotely, you may also see this message. Try again after connecting locally.)

  • You may receive a message to check your VirtualBox network configuration when you try to start the emulator. Follow the link and instructions to modify or remove the Host-only Network Adapter from VirtualBox. (VirtualBox is included with the installation of the emulator.)\

  • For high-performance emulation using Genymotion, disable Hyper-V before starting the emulator, as described earlier in Configure a high-performance emulator. Android developer tools see Genymotion as a physical device. When you use Visual Studio to run the app, you instruct Visual Studio to deploy to an Android device.

To run your app on the Genymotion emulator

  1. Start the Genymotion emulator.

  2. With your app open in Visual Studio, choose Android from the Solution Platforms list. If you don’t see this option, choose Solution Platforms from the Add/Remove Buttons list.

  3. In the device list, choose Device.

    Deploying to an Android device

  4. Press F5 to start the app, or Shift+F5 to start the app without debugging.

Troubleshooting? Let's fix it

If you have trouble deploying to Android emulators or devices, see Resolve Android build and deployment errors.

Android devices

Before you can use Visual Studio to run your app on a connected Android device, you must install the required driver:

  • Device-specific OEM driver, or

  • For Google Nexus devices, Google USB driver You must also make sure that your device is in developer mode. For instructions, see “Enabling On-device Developer Options” and “Setting up a Device for Development” in the Using Hardware Devices page on the Android website. To deploy a Release or Distribution configuration of your app, you must sign your app first. For more information, see Package your app.

To run your app on an Android device

  1. Make sure that you have installed the required OEM or Google USB driver.

  2. Make sure that your Android device is in developer mode (see Using Hardware Devices on the Android website).

  3. Make sure that adb (Android Debug Bridge) sees the device using adb.exe.

    1. Open a VisualStudio developer prompt in admin mode.

    2. Type the following command:

      "%ADT_HOME%\platform-tools\adb.exe" devices

      You should see your device in the list as shown here.

      Viewing your device using the Android Debug Bridge

  4. With your app open in Visual Studio, choose Android from the Solution Platforms list. (If you don’t see this option, choose Solution Platforms from the Add/Remove Buttons list.)

  5. In the device list, choose Device.

    Deploying to an Android device

  6. Press F5 to start the app, or Shift+F5 to start the app without debugging.

  7. When prompted, choose Allow USB Debugging.

Download the tools Get the Visual Studio Tools for Apache Cordova or learn more

See Also

Install Visual Studio Tools for Apache Cordova Debug Your App Built with Visual Studio Tools for Apache Cordova Package Your App