| commit | e2377b2cefef243d1c72c4bdbaf65fc9bb319114 | [log] [tgz] |
|---|---|---|
| author | Przemyslaw Pietrzkiewicz <ppi@chromium.org> | Fri Jul 31 14:00:44 2015 +0200 |
| committer | Przemyslaw Pietrzkiewicz <ppi@chromium.org> | Fri Jul 31 14:00:44 2015 +0200 |
| tree | a8876cd4e8364788b1eb8ab6aa67467208c83cbf | |
| parent | f932ccf42907b8f31fc705f1da7b0705e99e97fc [diff] |
Don't emulate Sky server when --sky is passed. The support for running Sky apps within a Mojo checkout broke when sky_engine moved out - as sky SDK packages are no longer built in Mojo checkout, we are not in position to emulate Sky server as we used to do. Running Sky apps is still possible, but one needs to indicate where sky_viewer is and run Sky server themselves. This patch updates the documentation and removes broken support. Fixes domokit/devtools#24. R=qsr@chromium.org Review URL: https://codereview.chromium.org/1264763003 . Cr-Mirrored-From: https://github.com/domokit/mojo Cr-Mirrored-Commit: 11e4fcd71e3283ec4c28e91aca581b03bef24327
Unopinionated tools for running, debugging and testing Mojo apps.
git clone https://github.com/domokit/devtools.git
Devtools offers the following tools:
mojo_run - shell runnermojo_test - apptest runnermojo_debug - debugger supporting interactive tracing and debugging of a running mojo shellAdditionally, remote_adb_setup script helps to configure adb on a remote machine to communicate with a device attached to a local machine, forwarding the ports used by mojo_run.
mojo_run allows you to run a Mojo shell either on the host, or on an attached Android device.
mojo_run APP_URL # Run on the host. mojo_run APP_URL --android # Run on Android device.
Unless running within a Mojo checkout, we need to indicate the path to the shell binary:
mojo_run --shell-path path/to/shell/binary APP_URL
To run a Sky app, you need to build sky_viewer.mojo in a Sky checkout, and indicate the path to the binary using the --map-url parameter:
mojo_run --map-url mojo:sky_viewer=/path/to/sky/viewer APP_URL
If the app does not declare a shebang indicating that it needs to be run in sky_viewer, pass --sky to map sky_viewer as a default content handler for dart apps:
mojo_run --map-url mojo:sky_viewer=/path/to/sky/viewer APP_URL --sky
Note that Sky apps will need the --use-osmesa flag to run over chromoting:
mojo_debug 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 mojo_debug script can be used to launch GDB and attach it to a running shell process (android only):
mojo_debug gdb attach
Once started, GDB will first stop the Mojo Shell execution, then load symbols from loaded Mojo applications. Please note that this initial step can take some time (up to several minutes in the worst case).
After each execution pause, GDB will update the set of loaded symbols based on the selected thread only. If you need symbols for all threads, use the update-symbols GDB command:
(gdb) update-symbols
If you only want to update symbols for the current selected thread (for example, after changing threads), use the current option:
(gdb) update-symbols current
When Mojo shell crashes on Android (“Unfortunately, Mojo shell has stopped.”) due to a crash in native code, mojo_debug 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.