| 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 |