Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(897)

Unified Diff: mojo/devtools/common/README.md

Issue 1264763003: Don't emulate Sky server when --sky is passed. (Closed) Base URL: git@github.com:domokit/mojo.git@master
Patch Set: Created 5 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « README.md ('k') | mojo/devtools/common/devtoolslib/paths.py » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: mojo/devtools/common/README.md
diff --git a/mojo/devtools/common/README.md b/mojo/devtools/common/README.md
index 7a2745b12daceaaef5a66fb78807b16f354a887f..4536ea528ba26458ab1fc1eeb219bdc4ef685668 100644
--- a/mojo/devtools/common/README.md
+++ b/mojo/devtools/common/README.md
@@ -21,10 +21,48 @@ Additionally, `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`.
+### Runner
+
+`mojo_run` allows you to run a Mojo shell either on the host, or on an attached
+Android device.
+
+```sh
+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:
+
+```sh
+mojo_run --shell-path path/to/shell/binary APP_URL
+```
+
+#### Sky apps
+
+To run a [Sky](https://github.com/domokit/sky_engine) app, you need to build
+`sky_viewer.mojo` in a Sky checkout, and indicate the path to the binary using
+the `--map-url` parameter:
+
+```sh
+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:
+
+```sh
+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](https://support.google.com/chrome/answer/1649523?hl=en):
+
### Debugger
-The `mojo_debug` script allows you to interactively inspect a running shell,
-collect performance traces and attach a gdb debugger.
+`mojo_debug` allows you to interactively inspect a running shell, collect
+performance traces and attach a gdb debugger.
#### Tracing
To collect [performance
« no previous file with comments | « README.md ('k') | mojo/devtools/common/devtoolslib/paths.py » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698