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

Side by Side Diff: mojo/devtools/common/docs/mojo_run.md

Issue 1844943004: devtools: download shell binaries and set origin when run w/ --mojo-version. (Closed) Base URL: git@github.com:domokit/mojo.git@master
Patch Set: Created 4 years, 8 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 unified diff | Download patch
« no previous file with comments | « mojo/devtools/common/devtoolslib/shell_config.py ('k') | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 # mojo_run 1 # mojo_run
2 2
3 `mojo_run` allows you to run a Mojo shell either on the host, or on an attached 3 `mojo_run` allows you to run a Mojo shell either on the host, or on an attached
4 Android device. 4 Android device.
5 5
6 ```sh 6 ```sh
7 mojo_run APP_URL # Run on the host. 7 mojo_run APP_URL # Run on Linux host.
8 mojo_run APP_URL --android # Run on Android device. 8 mojo_run APP_URL --android # Run on Android device.
9 mojo_run "APP_URL APP_ARGUMENTS" # Run an app with startup arguments 9 mojo_run "APP_URL APP_ARGUMENTS" # Run an app with startup arguments
10 ``` 10 ```
11 11
12 Unless running within a Mojo checkout, we need to indicate the path to the shell 12 ## mojo version
13 binary: 13
14 `mojo_run` will download mojo shell and configure it to use `mojo:` apps built
15 at the corresponding version, if you pass the git commit sha of the
16 https://github.com/domokit/mojo repository as `--mojo-version`:
14 17
15 ```sh 18 ```sh
16 mojo_run --shell-path path/to/shell/binary APP_URL 19 mojo_run APP_URL --mojo-version SOME_HASH
17 ``` 20 ```
18 21
22 If your project uses a pinned version of mojo, you can put the pinned hash in
23 a `MOJO_VERSION` file in any ancestor directory of `mojo_run`. This will make
24 `mojo_run` infer the parameter automatically.
25
26 If you don't want to use prebuilt binaries at the given version, you can
27 configure the shell binary and the origin to use manually:
28
29 ```sh
30 mojo_run APP_URL --shell-path path/to/shell/binary --origin ORIGIN_URL
31 ```
32
33 ## Running applications in a view
34
19 Some applications implement ViewProvider and are run embedded in a view. To run 35 Some applications implement ViewProvider and are run embedded in a view. To run
20 these, you can pass the app url using the `--embed` flag: 36 these, you can pass the app url using the `--embed` flag:
21 37
22 ```sh 38 ```sh
23 mojo_run --embed APP_URL [--android] 39 mojo_run --embed APP_URL [--android]
24 ``` 40 ```
25 41
26 ## Running multiple instances simultaneously 42 ## Running multiple instances simultaneously
27 43
28 `mojo_run` sets up development servers on fixed ports to facilitate caching 44 `mojo_run` sets up development servers on fixed ports to facilitate caching
(...skipping 29 matching lines...) Expand all
58 ```sh 74 ```sh
59 mojo_run APP_URL 75 mojo_run APP_URL
60 ``` 76 ```
61 77
62 and the following in another: 78 and the following in another:
63 79
64 ```sh 80 ```sh
65 mkdir ~/another_home 81 mkdir ~/another_home
66 HOME=~/another_home mojo_run APP_URL --reuse-servers 82 HOME=~/another_home mojo_run APP_URL --reuse-servers
67 ``` 83 ```
68
69 ## Setting default mojo origin
70
71 When run outside of the `domokit/mojo` repository, `mojo_run` needs `--origin`
72 parameter to indicate where binaries of the core mojo services come from. If a
73 `MOJO_VERSION` file is present among ancestors of `mojo_run` and `--origin`
74 parameter is not set, origin will point to Google Storage location storing
75 binaries of core mojo services built at the git revision indicated in
76 `MOJO_VERSION`.
OLDNEW
« no previous file with comments | « mojo/devtools/common/devtoolslib/shell_config.py ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698