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 82 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
93 ./build/android/adb_reverse_forwarder.py --debug -v 25467 25467 | 93 ./build/android/adb_reverse_forwarder.py --debug -v 25467 25467 |
94 ``` | 94 ``` |
95 | 95 |
96 ### Required engine binary flags | 96 ### Required engine binary flags |
97 * `--blimp-client-token-path=$PATH`: Path to a file containing a nonempty | 97 * `--blimp-client-token-path=$PATH`: Path to a file containing a nonempty |
98 token string. If this is not present, the engine will fail to boot. | 98 token string. If this is not present, the engine will fail to boot. |
99 * `--use-remote-compositing`: Ensures that the renderer uses the remote | 99 * `--use-remote-compositing`: Ensures that the renderer uses the remote |
100 compositor. | 100 compositor. |
101 * `--disable-cached-picture-raster`: Ensures that rasterized content is not | 101 * `--disable-cached-picture-raster`: Ensures that rasterized content is not |
102 destroyed before serialization. | 102 destroyed before serialization. |
| 103 * `--android-fonts-path=$PATH`: Path to where the fonts are located. |
| 104 Typically this would be `out-linux/Debug/gen/third_party/blimp_fonts`. |
103 | 105 |
104 #### Typical invocation | 106 #### Typical invocation |
105 When the client connects to a manually specified engine instead of using the | 107 When the client connects to a manually specified engine instead of using the |
106 assigner, it will use a dummy token. The engine needs to know what this token | 108 assigner, it will use a dummy token. The engine needs to know what this token |
107 is, so it must be provided using the `--blimp-client-token-path` flag. The token | 109 is, so it must be provided using the `--blimp-client-token-path` flag. The token |
108 is available in the constant `kDummyClientToken` in | 110 is available in the constant `kDummyClientToken` in |
109 `blimp/client/session/assignment_source.h`. You can easily store that to a file | 111 `blimp/client/session/assignment_source.h`. You can easily store that to a file |
110 by running the following command once: | 112 by running the following command once: |
111 | 113 |
112 ```bash | 114 ```bash |
113 awk '{if ( match($0, /^\s*const char kDummyClientToken.*/) ) { print substr($5,
2, length($5)-3);} }' \ | 115 awk '{if ( match($0, /^\s*const char kDummyClientToken.*/) ) { print substr($5,
2, length($5)-3);} }' \ |
114 ./blimp/client/session/assignment_source.h > /tmp/blimpengine-token | 116 ./blimp/client/session/assignment_source.h > /tmp/blimpengine-token |
115 ``` | 117 ``` |
116 | 118 |
117 Then start the engine using these flags: | 119 Then start the engine using these flags: |
118 | 120 |
119 ```bash | 121 ```bash |
120 out-linux/Debug/blimp_engine_app \ | 122 out-linux/Debug/blimp_engine_app \ |
121 --use-remote-compositing \ | 123 --use-remote-compositing \ |
122 --disable-cached-picture-raster \ | 124 --disable-cached-picture-raster \ |
123 --blimp-client-token-path=/tmp/blimpengine-token \ | 125 --blimp-client-token-path=/tmp/blimpengine-token \ |
124 --user-data-dir=/tmp/blimpengine \ | 126 --user-data-dir=/tmp/blimpengine \ |
| 127 --android-fonts-path=out-linux/Debug/gen/third_party/blimp_fonts \ |
125 --enable-logging=stderr \ | 128 --enable-logging=stderr \ |
126 --vmodule="blimp*=1" | 129 --vmodule="blimp*=1" |
127 ``` | 130 ``` |
OLD | NEW |