| Index: docs/android_build_instructions.md
|
| diff --git a/docs/android_build_instructions.md b/docs/android_build_instructions.md
|
| index ee3c399eeff7cc6cb53f9c3f0c3741e23b0a9ef4..6acb3fa3efca44fc4f166512d59036dce930f985 100644
|
| --- a/docs/android_build_instructions.md
|
| +++ b/docs/android_build_instructions.md
|
| @@ -1,6 +1,6 @@
|
| # Checking out and building Chromium for Android
|
|
|
| -There are instructions for other platforms linked from the
|
| +There are instructions for other platforms linked from the
|
| [get the code](get_the_code.md) page.
|
|
|
| ## Instructions for Google Employees
|
| @@ -311,11 +311,12 @@ For information on running tests, see [android\_test\_instructions.md](https://c
|
| ### Faster Edit/Deploy (GN only)
|
|
|
| GN's "incremental install" uses reflection and side-loading to speed up the edit
|
| -& deploy cycle (normally < 10 seconds).
|
| +& deploy cycle (normally < 10 seconds). The initial launch of the apk will be
|
| +a little slower since updated dex files are installed manually.
|
|
|
| * Make sure to set` is_component_build = true `in your GN args
|
| * All apk targets have \*`_incremental` targets defined (e.g.
|
| - `chrome_public_apk_incremental`)
|
| + `chrome_public_apk_incremental`) except for Webview and Monochrome
|
|
|
| Here's an example:
|
|
|
| @@ -345,6 +346,27 @@ To uninstall:
|
| out/Default/bin/install_chrome_public_apk_incremental -v --uninstall
|
| ```
|
|
|
| +A subtly erroneous flow arises when you build a regular apk but install an
|
| +incremental apk (e.g.
|
| +`ninja -C out/Default foo_apk && out/Default/bin/install_foo_apk_incremental`).
|
| +Setting `incremental_apk_by_default = true` in your GN args aliases regular
|
| +targets as their incremental counterparts. With this arg set, the commands
|
| +above become:
|
| +
|
| +```shell
|
| +ninja -C out/Default chrome_public_apk
|
| +out/Default/bin/install_chrome_public_apk
|
| +
|
| +ninja -C out/Default base_unittests
|
| +out/Default/bin/run_base_unittests
|
| +
|
| +ninja -C out/Default chrome_public_test_apk
|
| +out/Default/bin/run_chrome_public_test_apk
|
| +```
|
| +
|
| +If you want to build a non-incremental apk you'll need to remove
|
| +`incremental_apk_by_default` from your GN args.
|
| +
|
| ## Tips, tricks, and troubleshooting
|
|
|
| ### Rebuilding libchrome.so for a particular release
|
|
|