Skip to content

Latest commit

 

History

History
87 lines (66 loc) · 5.23 KB

tips-and-workarounds-android-readme.md

File metadata and controls

87 lines (66 loc) · 5.23 KB
Raw

#Android tips and workarounds This document covers tips, tricks, and known workarounds for problems with the Cordova Android platform.

Note: If your problem is security related, please read May 26th, 2015 Android Security Issue

##Resolve Android build and deployment errors

Try these steps if you have trouble building and deploying to Android emulators or devices. In some cases, you may see an error about a failure to install the APK on the device or a failure to run the Android Debug Bridge (ADB.exe).

Note: For instructions to run for the first time on specific emulators or an Android device, see Run your app on Android.

  1. Before taking any other steps, try running your app against other platforms or emulators to make sure the issue is Android-specific.

    For example, we suggest you test on Windows:

    • Open the configuration designer (config.xml), the Windows tab, select your OS version, and then try running against Windows-x64 or Windows-x86 and select Local Machine.

    If you see the same error on other platforms, the issue is likely not Android-specific, see Resolve build and deployment errors for more general help.

  2. If you are running on an Android device, make sure that Developer Mode is enabled on the device. Try the instructions here to enable developer mode.

    After you enable developer mode, go to Developer options on the device and enable Android debugging (USB Debugging). In USB settings, also make sure you are connecting as a Media device.

  3. If you are running on a device and the app is already installed, uninstall the app and try again.

  4. Verify that the Android SDK can connect to your device or emulator. To do this, take these steps.

    • Start an emulator or connect a device.
    • Open a command line and go to the folder where abd.exe is installed. For example, this might be C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe
    • Type the command adb devices and you should see a connected device. See the connected devices

    If you don't see the device, restart your device or emulator and use a different USB port. (Sometimes, front USB ports are low power ports. Avoid using a USB extension cable.) Recheck using adb devices.

    For additional ADB commands, see this article.

  5. Make sure that you have the required SDK components installed.

  6. If there appears to be a problem with the Android SDK, you may need to re-install it. Before re-installing, delete the /User/username/.android and the /User/username/.gradle folder to make sure you get a fresh copy of the SDK. After installing the SDK, try again.

##Could not create Java Virtual Machine error When building for Android, you may encounter a set of errors in the Errors List like the following:

Error		Could not create the Java Virtual Machine.			
Error		A fatal exception has occurred. Program will exit.									
Error		C:\cordova\BlankCordovaApp2\BlankCordovaApp2\platforms\android\cordova\build.bat: Command failed with exit code 1

The problem is that the Ant or Gradle build systems are running out of heap memory when you try to compile your app. To resolve this problem, you can increase the heap of the JVM by setting the following environment variable and restarting Visual Studio:

_JAVA_OPTIONS=-Xmx512M

More specifically, following the instructions from this article:

  1. Close Visual Studio, if you do not close it - you will need to restart it at the end.
  2. Open the Control Panel.
  3. Go to System and Security.
  4. Go to System.
  5. Go to Advanced systems settings.
  6. Go to Environment Variables... (on the Advanced tab).
  7. Under System Variables, click New
  8. Variable Name: _JAVA_OPTIONS.
  9. Variable Value: -Xmx512M.
  10. Click OK to close the dialog.
  11. Click OK to close Environment Variables.
  12. Click OK to close System Properties.
  13. Now open Visual Studio.

If this does not resolve the issue, you can upgrade to a 64-bit version of the JDK from here and update the JAVA_HOME environment variable to the new install location.

More Information