On Windows, Linux, and Mac ANGLE now builds most core components cross platform, including the shader validator and translator as well as the graphics API translator. These parts can be built and tested inside a Chromium checkout.
Steps:
- Checkout and build Chromium.
- You should now be able to use
ninja -C out/Debug angle_end2end_tests
, for example.
On Mac, ANGLE doesn't yet include the dEQP tests or the API translation libraries as part of Chromium. ANGLE also includes some sample applications and a few other targets that don't build on Chromium. These steps describe how to build such targets within a Chromium checkout.
Steps:
cd src/third_party/angle
gclient config --name . --unmanaged https://chromium.googlesource.com/angle/angle.git
gclient sync
git checkout master
- To make the build files run these commands
cd src/third_party/angle
GYP_GENERATORS=ninja gclient runhooks
- To build
cd src/third_party/angle
ninja -j 10 -k1 -C out/Debug
- To build a specific target add the target at the end:
cd src/third_party/angle
ninja -j 10 -k1 -C out/Debug angle_gles2_deqp_tests
- To run
cd src/third_party/angle
./out/Debug/hello_triangle
If you decide to go back to the Chromium-managed version, just remove the .gclient
file.
If you're actively developing within ANGLE in your Chromium workspace you will want to work with top of tree ANGLE. To do this do the following:
- Ignore ANGLE in your
.gclient
solutions = [
{
# ...
u'custom_deps':
{
"src/third_party/angle": None,
},
},
]
You then have full control over your ANGLE workspace and are responsible for running all git commands (pull, rebase, etc.) for managing your branches.
If you decide you need to go back to the DEPS version of ANGLE:
- Comment out the
src/third_party/angle
line in yourcustom_deps
. - Go into your ANGLE workspace and switch back to the master branch (ensure there are no modified or new files).
gclient sync
your Chromium workspace.