This guide, which is meant to accompany the compilation guide, explains the process of viewing the logs and debugging the CRD Android client. I‘ll assume you’ve already built the APK as described in the aforementioned guide, that you're in the src/
directory, and that your binary is at out/Release/apks/Chromoting.apk
. Additionally, you should have installed the app on at least one (still) connected device.
In order to access LogCat and view the app's logging output, we need to launch the Android Device Monitor. Run third_party/android_sdk/public/tools/monitor
and select the desired device under Devices
. Using the app as normal will display log messages to the LogCat
pane.
<?xml version="1.0" encoding="UTF-8"?> <classpath> <classpathentry kind="src" path="net/test/android/javatests/src"/> <classpathentry kind="src" path="net/android/java/src"/> <classpathentry kind="src" path="net/android/javatests/src"/> <classpathentry kind="src" path="base/test/android/java/src"/> <classpathentry kind="src" path="base/test/android/javatests/src"/> <classpathentry kind="src" path="base/android/jni_generator/java/src"/> <classpathentry kind="src" path="base/android/java/src"/> <classpathentry kind="src" path="base/android/javatests/src"/> <classpathentry kind="src" path="components/cronet/android/java/src"/> <classpathentry kind="src" path="components/cronet/android/sample/src"/> <classpathentry kind="src" path="components/cronet/android/sample/javatests/src"/> <classpathentry kind="src" path="components/autofill/core/browser/android/java/src"/> <classpathentry kind="src" path="components/embedder_support/android/java/src"/> <classpathentry kind="src" path="components/dom_distiller/android/java/src"/> <classpathentry kind="src" path="components/navigation_interception/android/java/src"/> <classpathentry kind="src" path="ui/android/java/src"/> <classpathentry kind="src" path="media/base/android/java/src"/> <classpathentry kind="src" path="chrome/test/android/unit_tests_apk/src"/> <classpathentry kind="src" path="chrome/test/android/javatests/src"/> <classpathentry kind="src" path="chrome/test/chromedriver/test/webview_shell/java/src"/> <classpathentry kind="src" path="chrome/common/extensions/docs/examples/extensions/irc/servlet/src"/> <classpathentry kind="src" path="chrome/android/java/src"/> <classpathentry kind="src" path="chrome/android/uiautomator_tests/src"/> <classpathentry kind="src" path="chrome/android/javatests/src"/> <classpathentry kind="src" path="sync/test/android/javatests/src"/> <classpathentry kind="src" path="sync/android/java/src"/> <classpathentry kind="src" path="sync/android/javatests/src"/> <classpathentry kind="src" path="mojo/public/java/base/src"/> <classpathentry kind="src" path="mojo/public/java/bindings/src"/> <classpathentry kind="src" path="mojo/public/java/system/javatests/src"/> <classpathentry kind="src" path="mojo/public/java/system/src"/> <classpathentry kind="src" path="testing/android/java/src"/> <classpathentry kind="src" path="printing/android/java/src"/> <classpathentry kind="src" path="tools/binary_size/java/src"/> <classpathentry kind="src" path="tools/android/memconsumer/java/src"/> <classpathentry kind="src" path="remoting/android/java/src"/> <classpathentry kind="src" path="remoting/android/apk/src"/> <classpathentry kind="src" path="remoting/android/javatests/src"/> <classpathentry kind="src" path="third_party/blink/renderer/devtools/scripts/jsdoc-validator/src"/> <classpathentry kind="src" path="third_party/blink/renderer/devtools/scripts/compiler-runner/src"/> <classpathentry kind="src" path="third_party/webrtc/voice_engine/test/android/android_test/src"/> <classpathentry kind="src" path="third_party/webrtc/modules/video_capture/android/java/src"/> <classpathentry kind="src" path="third_party/webrtc/modules/video_render/android/java/src"/> <classpathentry kind="src" path="third_party/webrtc/modules/audio_device/test/android/audio_device_android_test/src"/> <classpathentry kind="src" path="third_party/webrtc/modules/audio_device/android/java/src"/> <classpathentry kind="src" path="third_party/webrtc/examples/android/media_demo/src"/> <classpathentry kind="src" path="third_party/webrtc/examples/android/opensl_loopback/src"/> <classpathentry kind="src" path="third_party/webrtc/video_engine/test/auto_test/android/src"/> <classpathentry kind="src" path="third_party/libjingle/source/talk/app/webrtc/java/src"/> <classpathentry kind="src" path="third_party/libjingle/source/talk/app/webrtc/javatests/src"/> <classpathentry kind="src" path="third_party/libjingle/source/talk/examples/android/src"/> <classpathentry kind="src" path="android_webview/java/src"/> <classpathentry kind="src" path="android_webview/test/shell/src"/> <classpathentry kind="src" path="android_webview/unittestjava/src"/> <classpathentry kind="src" path="android_webview/javatests/src"/> <classpathentry kind="src" path="content/public/test/android/javatests/src"/> <classpathentry kind="src" path="content/public/android/java/src"/> <classpathentry kind="src" path="content/public/android/javatests/src"/> <classpathentry kind="src" path="content/shell/android/browsertests_apk/src"/> <classpathentry kind="src" path="content/shell/android/java/src"/> <classpathentry kind="src" path="content/shell/android/shell_apk/src"/> <classpathentry kind="src" path="content/shell/android/javatests/src"/> <classpathentry kind="src" path="content/shell/android/linker_test_apk/src"/> <classpathentry kind="lib" path="third_party/android_sdk/public/platforms/android-27/data/layoutlib.jar"/> <classpathentry kind="lib" path="third_party/android_sdk/public/platforms/android-27/android.jar"/> <classpathentry kind="output" path="out/bin"/> </classpath>
With the Android Device Monitor open, look under Devices
, expand the entry for the device on which you want to debug, and select the entry for org.chromium.chromoting
(it must already be running). This forwards the JVM debugging connection to your local port 8700. In your shell, do $ jdb -attach localhost:8700
.
The Chromium build system provides a convenience wrapper script that can be used to easily launch GDB. Run
$ build/android/adb_gdb --package-name=org.chromium.chromoting \ --activity=.Chromoting --start
Note that if you have multiple devices connected, you must export ANDROID_SERIAL
to select one; set it to the serial number of the desired device as output by $ adb devices
.