OLD | NEW |
1 # Running Blimp | 1 # Running Blimp |
2 [TOC] | 2 [TOC] |
3 | 3 |
4 See [build](build.md) for instructions on how to build Blimp. | 4 See [build](build.md) for instructions on how to build Blimp. |
5 | 5 |
6 ## Android Client | 6 ## Android Client |
7 | 7 |
8 ### Installing the client | 8 ### Installing the client |
9 | 9 |
10 Install the Chrome Public APK with the following: | 10 Install the Chrome Public APK with the following: |
(...skipping 134 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
145 * Some of scripts under `build/android` will fail to run as it uses `adb scp`. | 145 * Some of scripts under `build/android` will fail to run as it uses `adb scp`. |
146 Follow the instruction above to use `adb` directly. | 146 Follow the instruction above to use `adb` directly. |
147 | 147 |
148 * To connect to an Engine running on the host machine, you should use | 148 * To connect to an Engine running on the host machine, you should use |
149 `10.0.2.2` as `engine-ip` instead of `127.0.0.1` as `127.0.0.1` will refer to | 149 `10.0.2.2` as `engine-ip` instead of `127.0.0.1` as `127.0.0.1` will refer to |
150 the emulator itself. There is no need of set up | 150 the emulator itself. There is no need of set up |
151 [port forwarding](#Port-forwarding) when this approach is used. | 151 [port forwarding](#Port-forwarding) when this approach is used. |
152 | 152 |
153 ## Linux Client | 153 ## Linux Client |
154 | 154 |
155 The Linux client is used for development purpose while the Android client is | 155 The Linux client is useful for development purposes where the full Android UI is |
156 shipped. The Linux client is built as part of the `blimp` target. | 156 not required. |
| 157 |
| 158 Build with the following commands: |
| 159 ``` |
| 160 gn gen out-linux/Client |
| 161 ninja -C out-linux/Client blimp_shell |
| 162 ``` |
| 163 |
| 164 |
157 To run it with local logging enabled, execute: | 165 To run it with local logging enabled, execute: |
158 | 166 |
159 ```bash | 167 ```bash |
160 ./out-linux/Debug/blimp_shell \ | 168 ./out-linux/Client/blimp_shell \ |
161 --user-data-dir=/tmp/blimpclient \ | 169 --user-data-dir=/tmp/blimpclient \ |
162 --enable-logging=stderr \ | 170 --enable-logging=stderr \ |
163 --vmodule="*=1" | 171 --vmodule="*=1" \ |
| 172 --engine-ip=127.0.0.1 \ |
| 173 --engine-port=25467 \ |
| 174 --engine-transport=tcp \ |
| 175 --blimp-client-token-path=/tmp/blimpengine-token |
| 176 ``` |
| 177 |
| 178 **PS:** Create the `/tmp/blimpengine-token` file with any sequence of |
| 179 characters. For example: |
| 180 |
| 181 ``` |
| 182 echo "anything" > /tmp/blimpengine-token |
164 ``` | 183 ``` |
165 | 184 |
166 ## Running the engine | 185 ## Running the engine |
167 | 186 |
168 ### In a container | 187 ### In a container |
169 For running the engine in a container, see [container](container.md). | 188 For running the engine in a container, see [container](container.md). |
170 | 189 |
171 ### On a workstation | 190 ### On a workstation |
172 The following flags are required to start an Engine instance: | 191 The following flags are required to start an Engine instance: |
173 | 192 |
(...skipping 81 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
255 killing engine if keyboard interrupts or client gets killed. | 274 killing engine if keyboard interrupts or client gets killed. |
256 | 275 |
257 ```bash | 276 ```bash |
258 out-linux/Debug/bin/client_engine_integration run | 277 out-linux/Debug/bin/client_engine_integration run |
259 ``` | 278 ``` |
260 | 279 |
261 2. Same as step 2 in Option A. | 280 2. Same as step 2 in Option A. |
262 | 281 |
263 3. Engine should be auto-killed by keyboard stopping the `{run}` script or the
client | 282 3. Engine should be auto-killed by keyboard stopping the `{run}` script or the
client |
264 gets wiped out. `{stop}` works as well. | 283 gets wiped out. `{stop}` works as well. |
OLD | NEW |