Clone this repo:


  1. 20d9438 Add phoglund@ to various OWNERS and remove kjellander@. by Henrik Kjellander · 5 weeks ago master
  2. 9f2cefc Remove build_overrides/webrtc.gni by Henrik Kjellander · 8 weeks ago
  3. 21de456 Speed up "gn gen" by ~65ms for non-mac host_os by Andrew Grieve · 4 months ago
  4. f213759 Remove mac_sdk_min_build_override. by Erik Chen · 4 months ago
  5. 2d0551a Allow macOS default SDK to be set from environment variable. by Erik Chen · 4 months ago

Build overrides in GN

This directory is used to allow different products to customize settings for repos that are DEPS'ed in or shared.

For example: V8 could be built on its own (in a “standalone” configuration), and it could be built as part of Chromium. V8 might define a top-level target, //v8:d8 (a simple executable), that should only be built in the standalone configuration. To figure out whether or not it should be in a standalone configuration, v8 can create a file, build_overrides/v8.gni, that contains a variable, build_standalone_d8 = true. and import it (as import(“//build_overrides/v8.gni”) from its top-level file.

Chromium, on the other hand, might not need to build d8, and so it would create its own build_overrides/v8.gni file, and in it set build_standalone_d8 = false.

The two files should define the same set of variables, but the values can vary as appropriate to the needs of the two different builds.

The build.gni file provides a way for projects to override defaults for variables used in //build itself (which we want to be shareable between projects).

TODO( Ideally //build_overrides and, in particular, //build_overrides/build.gni should go away completely in favor of some mechanism that can re-use other required files like //.gn, so that we don't have to keep requiring projects to create a bunch of different files to use GN.