Skip to content
This repository has been archived by the owner on Apr 3, 2020. It is now read-only.

Remote debugging on android

Jump to bottom
Elliot Smith edited this page Aug 8, 2014 · 11 revisions

Map of Crosswalk versions to Chrome versions

Before debugging your web application, make sure the right Google Chrome version is installed on the host machine. If you fail to do this, the remote debugging functionality may not work as expected. The following table shows which version of Chrome you need to debug a given Crosswalk version.

Version Mapping Table

Crosswalk Version Google Chrome Version
Crosswalk-1 >= 29
Crosswalk-2 >= 31
Crosswalk-3 >= 32
Crosswalk-4 >= 32
Crosswalk-5 >= 34
Crosswalk-6 >= 35
Crosswalk-7 >= 36

You can also examine the Chrome version via the navigator.userAgent property in your web application.

Remote debugging for web applications on Android

Developers can use remote debugging to debug web applications on Android from Chrome Browser on Linux host machines.

  • Two ways to enable the remote debugging feature for a web application. You can either enable the remote debugging by default when packaging the web app or send Android intents to the web app if it's running.
  • Option 1: Enable remote debugging by default when packaging a web app, for example,
  host$ python make_apk.py --package=com.abc.app --name=ABC --app-root=/home/abc/dist --app-local-path=src/index.html --enable-remote-debugging

Launch the packaged web app APK and remote debugging is enabled by default.

  • Option 2: If a web app APK is not packaged with remote debugging, you can launch it and send an intent to enable/disable remote debugging when it's running. Note that below intent will enable remote debugging feature for all running web apps with Crosswalk.
  host$ adb shell am broadcast -a org.xwalk.intent -e remotedebugging true
  • To disable remote debugging if a web app is running,
  host$ adb shell am broadcast -a org.xwalk.intent -e remotedebugging false
  • Inspect web pages or web apps in Chrome Browser
  • Open Chrome Browser(version >=29) in the host machine and input "chrome://inspect" in the address bar.
  • Web pages or web apps will be shown in the inspection page. Click to the button 'inspect' to inspect it.

Remote debugging for XWalk Core Shell on Android

XWalkCoreShell is an internal test shell for Crosswalk developers. It enables remote debugging by default. Follow the steps 'Inspect web pages or web apps in Chrome Browser.

Trouble shooting

If you can't see the web page or web app shown in Chrome Browser in the host machine, please check with below steps:

host$ adb shell 
shell@android$ cat /proc/net/unix |grep devtools_remote
00000000: 00000002 00000000 00010000 0001 01 1102698 @com.abc.app_devtools_remote
00000000: 00000002 00000000 00010000 0001 01 1092981 @org.xwalk.core.xwview.shell_devtools_remote

If you don't see the string combined with the package name and '_devtools_remote', then you probably have to enable remote debugging for the web app.

Reference

Clone this wiki locally