| commit | 7ebd7f95458dfbf70abdcf6aebfbce7de03b3729 | [log] [tgz] |
|---|---|---|
| author | Przemysław Pietrzkiewicz <ppi@chromium.org> | Thu Jul 23 09:50:13 2015 -0700 |
| committer | Przemysław Pietrzkiewicz <ppi@chromium.org> | Thu Jul 23 09:50:13 2015 -0700 |
| tree | 22cccd2d519807d8d74decadf78eed5b327e0807 | |
| parent | 6053c39bb90bef15de4e0988588d7a4f22c04b68 [diff] |
Rename shell runner and debugger -> mojo_run, mojo_debug. R=qsr@chromium.org Review URL: https://codereview.chromium.org/1241263009 . Cr-Mirrored-From: https://github.com/domokit/mojo Cr-Mirrored-Commit: 1a58f2cb85e0c982fb4cb39f7432516953d2c33c
Unopinionated tools for running, debugging and testing Mojo apps.
git clone https://github.com/domokit/devtools.git
Devtools offers the following tools:
mojo_run - universal shell runnermojo_debug - supports interactive tracing and debugging of a running mojo shellremote_adb_setup - configures adb on a remote machine to communicate with a device attached to the local machineand a Python scripting library designed for being embedded (devtoolslib).
The mojo_debug script allows you to interactively inspect a running shell, collect performance traces and attach a gdb debugger.
To collect performance traces and retrieve the result:
mojo_debug tracing start mojo_debug tracing stop [result.json]
The trace file can be then loaded using the trace viewer in Chrome available at about://tracing.
It is possible to inspect a Mojo Shell process using GDB. The debugger script can be used to launch GDB and attach it to a running shell process (android only):
mojo_debug gdb attach
When Mojo shell crashes on Android (“Unfortunately, Mojo shell has stopped.”) due to a crash in native code, debugger can be used to find and symbolize the stack trace present in the device log:
mojo_debug device stack
devtoolslib is a Python module containing the core scripting functionality for running Mojo apps: shell abstraction with implementations for Android and Linux and support for apptest frameworks. The executable scripts in devtools are based on this module. One can also choose to embed the functionality provided by devtoolslib in their own wrapper.
The library is canonically developed in the mojo repository, https://github.com/domokit/devtools is a mirror allowing to consume it separately.