Index: mojo/devtools/common/docs/mojo_run.md |
diff --git a/mojo/devtools/common/docs/mojo_run.md b/mojo/devtools/common/docs/mojo_run.md |
index aa60937ca1dc1af9ddb00d518e9460bd5a4affad..9279cd6e3d70a6483bf415250475e1b1b2319fca 100644 |
--- a/mojo/devtools/common/docs/mojo_run.md |
+++ b/mojo/devtools/common/docs/mojo_run.md |
@@ -4,18 +4,34 @@ |
Android device. |
```sh |
-mojo_run APP_URL # Run on the host. |
+mojo_run APP_URL # Run on Linux host. |
mojo_run APP_URL --android # Run on Android device. |
mojo_run "APP_URL APP_ARGUMENTS" # Run an app with startup arguments |
``` |
-Unless running within a Mojo checkout, we need to indicate the path to the shell |
-binary: |
+## mojo version |
+ |
+`mojo_run` will download mojo shell and configure it to use `mojo:` apps built |
+at the corresponding version, if you pass the git commit sha of the |
+https://github.com/domokit/mojo repository as `--mojo-version`: |
```sh |
-mojo_run --shell-path path/to/shell/binary APP_URL |
+mojo_run APP_URL --mojo-version SOME_HASH |
``` |
+If your project uses a pinned version of mojo, you can put the pinned hash in |
+a `MOJO_VERSION` file in any ancestor directory of `mojo_run`. This will make |
+`mojo_run` infer the parameter automatically. |
+ |
+If you don't want to use prebuilt binaries at the given version, you can |
+configure the shell binary and the origin to use manually: |
+ |
+```sh |
+mojo_run APP_URL --shell-path path/to/shell/binary --origin ORIGIN_URL |
+``` |
+ |
+## Running applications in a view |
+ |
Some applications implement ViewProvider and are run embedded in a view. To run |
these, you can pass the app url using the `--embed` flag: |
@@ -65,12 +81,3 @@ and the following in another: |
mkdir ~/another_home |
HOME=~/another_home mojo_run APP_URL --reuse-servers |
``` |
- |
-## Setting default mojo origin |
- |
-When run outside of the `domokit/mojo` repository, `mojo_run` needs `--origin` |
-parameter to indicate where binaries of the core mojo services come from. If a |
-`MOJO_VERSION` file is present among ancestors of `mojo_run` and `--origin` |
-parameter is not set, origin will point to Google Storage location storing |
-binaries of core mojo services built at the git revision indicated in |
-`MOJO_VERSION`. |