aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorYuly Novikov <ynovikov@chromium.org>2018-02-08 16:18:37 -0500
committerCommit Bot <commit-bot@chromium.org>2018-02-09 23:03:27 +0000
commit8f27b05092640bde80e8a1e6bda9f364f7921960 (patch)
treec35c420ad84352bdb3303de017dc9464b399b827 /doc
parent6108b766b371a6e2261d7e2e130126a120fd4d05 (diff)
downloadangle-8f27b05092640bde80e8a1e6bda9f364f7921960.tar.gz
Update Android build instructions
Build flags to enable Vulkan backend and some small updates. BUG=angleproject:2314 Change-Id: Ia99cc5a4b326a4cab115652cb12b3fb61033eeee Reviewed-on: https://chromium-review.googlesource.com/909723 Commit-Queue: Yuly Novikov <ynovikov@chromium.org> Reviewed-by: Jamie Madill <jmadill@chromium.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/DevSetup.md14
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/DevSetup.md b/doc/DevSetup.md
index 9495cf4e23..6e5623a46f 100644
--- a/doc/DevSetup.md
+++ b/doc/DevSetup.md
@@ -88,13 +88,12 @@ In Visual Studio:
Once the build completes the output directory for your selected configuration (e.g. `out/Release_x64`) will contain the required libraries and dlls to build and run an OpenGL ES 2.0 application. ANGLE executables (tests and samples) are under out/sln.
### Building ANGLE for Android
-At present it is not possible to build standalone ANGLE for Android but it can be built within a Chromium checkout.
-Since ANGLE has converted to GN a standalone build should be possible.
-For now follow the steps in
+Building ANGLE for Android is heavily dependent on the Chromium toolchain. It is not currently possible to build ANGLE for Android without a Chromium checkout. See http://anglebug.com/2344 for more details on why.
+Please follow the steps in
[Checking out and building Chromium for Android](https://chromium.googlesource.com/chromium/src/+/master/docs/android_build_instructions.md).
This must be done on Linux, the only platform that Chromium for Android supports.
Name your output directories `out/Debug` and `out/Release`, because Chromium GPU tests look for browser binaries in these folders. Replacing `out` with other names seems to be OK when working with multiple build configurations.
-It's best to use a build configuration of some Android bot on [GPU.FYI waterfall](https://build.chromium.org/p/chromium.gpu.fyi/waterfall). Look for `generate_build_files` step output of that bot. Remove `goma_dir` flag.
+It's best to use a build configuration of some Android bot on [GPU.FYI waterfall](https://ci.chromium.org/p/chromium/g/chromium.gpu.fyi/console). Look for `generate_build_files` step output of that bot. Remove `goma_dir` flag.
For example, these are the build flags from Nexus 5X bot:
```
build_angle_deqp_tests = true
@@ -108,9 +107,14 @@ target_cpu = "arm64" # Nexus 5X is 64 bit, remove this on 32 bit device
target_os = "android"
use_goma = true # Remove this if you don't have goma
```
+Additional flags to build the Vulkan backend, enable only if running on Android N or higher:
+```
+android32_ndk_api_level = 24
+android64_ndk_api_level = 24
+```
These ANGLE targets are supported:
-`ninja -C out/Release translator libEGL libGLESv2 angle_unittests angle_end2end_tests angle_white_box_tests angle_deqp_gles2_tests angle_deqp_gles3_tests angle_deqp_egl_tests`
+`ninja -C out/Release translator libEGL libGLESv2 angle_unittests angle_end2end_tests angle_white_box_tests angle_deqp_gles2_tests angle_deqp_gles3_tests angle_deqp_egl_tests angle_perftests`
In order to run ANGLE tests, prepend `bin/run_` to the test name, for example: `./out/Release/bin/run_angle_unittests`.
Additional details are in [Android Test Instructions](https://chromium.googlesource.com/chromium/src/+/master/docs/android_test_instructions.md).