OLD | NEW |
---|---|
1 # Running Blimp | 1 # Running Blimp |
2 | 2 |
3 See [build](build.md) for instructions on how to build Blimp. | 3 See [build](build.md) for instructions on how to build Blimp. |
4 | 4 |
5 ## Running the client | 5 ## Running the client |
6 | 6 |
7 There are both Android and Linux clients. The Android client is the shipping | 7 There are both Android and Linux clients. The Android client is the shipping |
8 client while the Linux client is used for development purposes. | 8 client while the Linux client is used for development purposes. |
9 | 9 |
10 ### Android Client | 10 ### Android Client |
(...skipping 77 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
88 ./build/android/adb_reverse_forwarder.py --debug -v 25467 25467 | 88 ./build/android/adb_reverse_forwarder.py --debug -v 25467 25467 |
89 ``` | 89 ``` |
90 | 90 |
91 ### Required engine binary flags | 91 ### Required engine binary flags |
92 * `--blimp-client-token-path=$PATH`: Path to a file containing a nonempty | 92 * `--blimp-client-token-path=$PATH`: Path to a file containing a nonempty |
93 token string. If this is not present, the engine will fail to boot. | 93 token string. If this is not present, the engine will fail to boot. |
94 * `--use-remote-compositing`: Ensures that the renderer uses the remote | 94 * `--use-remote-compositing`: Ensures that the renderer uses the remote |
95 compositor. | 95 compositor. |
96 * `--disable-cached-picture-raster`: Ensures that rasterized content is not | 96 * `--disable-cached-picture-raster`: Ensures that rasterized content is not |
97 destroyed before serialization. | 97 destroyed before serialization. |
98 * `--android-fonts-location=$PATH`: Path to where the fonts are located. | |
maniscalco
2016/02/25 00:56:54
-location vs -path? Seems like we use -path elsew
nyquist
2016/02/25 01:16:40
Agreed. I added a comment to the CL that is planni
maniscalco
2016/02/25 16:54:05
Thanks for following up on this!
| |
99 Typically this would be `out-linux/Debug/gen/blimp/fonts`. | |
98 | 100 |
99 #### Typical invocation | 101 #### Typical invocation |
100 When the client connects to a manually specified engine instead of using the | 102 When the client connects to a manually specified engine instead of using the |
101 assigner, it will use a dummy token. The engine needs to know what this token | 103 assigner, it will use a dummy token. The engine needs to know what this token |
102 is, so it must be provided using the `--blimp-client-token-path` flag. The token | 104 is, so it must be provided using the `--blimp-client-token-path` flag. The token |
103 is available in the constant `kDummyClientToken` in | 105 is available in the constant `kDummyClientToken` in |
104 `blimp/client/session/assignment_source.h`. You can easily store that to a file | 106 `blimp/client/session/assignment_source.h`. You can easily store that to a file |
105 by running the following command once: | 107 by running the following command once: |
106 | 108 |
107 ```bash | 109 ```bash |
108 awk '{if ( match($0, /^\s*const char kDummyClientToken.*/) ) { print substr($5, 2, length($5)-3);} }' \ | 110 awk '{if ( match($0, /^\s*const char kDummyClientToken.*/) ) { print substr($5, 2, length($5)-3);} }' \ |
109 ./blimp/client/session/assignment_source.h > /tmp/blimpengine-token | 111 ./blimp/client/session/assignment_source.h > /tmp/blimpengine-token |
110 ``` | 112 ``` |
111 | 113 |
112 Then start the engine using these flags: | 114 Then start the engine using these flags: |
113 | 115 |
114 ```bash | 116 ```bash |
115 out-linux/Debug/blimp_engine_app \ | 117 out-linux/Debug/blimp_engine_app \ |
116 --use-remote-compositing \ | 118 --use-remote-compositing \ |
117 --disable-cached-picture-raster \ | 119 --disable-cached-picture-raster \ |
118 --blimp-client-token-path=/tmp/blimpengine-token \ | 120 --blimp-client-token-path=/tmp/blimpengine-token \ |
119 --user-data-dir=/tmp/blimpengine \ | 121 --user-data-dir=/tmp/blimpengine \ |
122 --android-fonts-location=out-linux/Debug/gen/blimp/fonts \ | |
120 --enable-logging=stderr \ | 123 --enable-logging=stderr \ |
121 --vmodule="blimp*=1" | 124 --vmodule="blimp*=1" |
122 ``` | 125 ``` |
OLD | NEW |