Document the need for is_component_build = false
Setting `is_component_build = false` in the GN args is highly
recommended for standalone builds on Windows, to support the common
practice of moving libEGL.dll and libGLESv2.dll to an application's
directory. It makes them self-contained instead of depending on other
DLLs (like e.g. ext-ms-win-kernel32-sidebyside-l1-1-0.dll).
One notable exception is that the non-component build still depends on
d3dcompiler_47.dll, if the Direct3D backend is being used.
Bug: angleproject:6202
Change-Id: Id13e902d3169b37ec00a8065d9063ec7d683134b
Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/3042543
Reviewed-by: Geoff Lang <geofflang@chromium.org>
Commit-Queue: Nicolas Capens <nicolascapens@google.com>
diff --git a/doc/DevSetup.md b/doc/DevSetup.md
index 17c458b..3bb5839 100644
--- a/doc/DevSetup.md
+++ b/doc/DevSetup.md
@@ -56,6 +56,7 @@
GN will generate ninja files. To change the default build options run `gn args out/Debug`. Some commonly used options are:
```
+is_component_build = false (links dependencies into the build targets)
target_cpu = "x86" (default is "x64")
is_clang = false (to use system default compiler instead of clang)
is_debug = false (for release builds. is_debug = true is the default)
@@ -65,6 +66,9 @@
For a release build run `gn args out/Release` and set `is_debug = false`.
On Windows, you can build for the Universal Windows Platform (UWP) by setting `target_os = "winuwp"` in the args.
+Setting `is_component_build = false` is highly recommended to support moving libEGL.dll and libGLESv2.dll to an
+application's directory and being self-contained, instead of depending on other DLLs (d3dcompiler_47.dll is still
+needed for the Direct3D backend).
For more information on GN run `gn help`.
