1 # This file is used by the GN meta build system to find the root of the source
2 # tree and to set startup options. For documentation on the values set in this
3 # file, run "gn help dotfile" at the command line.
5 import("//build/dotfile_settings.gni")
6 import("//third_party/angle/dotfile_settings.gni")
8 # The location of the build configuration file.
9 buildconfig = "//build/config/BUILDCONFIG.gn"
11 # The secondary source root is a parallel directory tree where
12 # GN build files are placed when they can not be placed directly
13 # in the source tree, e.g. for third party source trees.
14 secondary_source = "//build/secondary/"
16 # The python interpreter to use by default. On Windows, this will look
17 # for python3.exe and python3.bat.
18 script_executable = "python3"
20 # These arguments override the default values for items in a declare_args
21 # block. "gn args" in turn can override these.
23 # In general the value for a build arg in the declare_args block should be the
24 # default. In some cases, a DEPS-ed in project will want different defaults for
25 # being built as part of Chrome vs. being built standalone. In this case, the
26 # Chrome defaults should go here. There should be no overrides here for
27 # values declared in the main Chrome repository.
29 # Important note for defining defaults: This file is executed before the
30 # BUILDCONFIG.gn file. That file sets up the global variables like "is_ios".
31 # This means that the default_args can not depend on the platform,
32 # architecture, or other build parameters. If you really need that, the other
33 # repo should define a flag that toggles on a behavior that implements the
34 # additional logic required by Chrome to set the variables.
36 # TODO(brettw) bug 684096: Chrome on iOS does not build v8, so "gn gen" prints
37 # a warning that "Build argument has no effect". When adding a v8 variable, it
38 # also needs to be defined to src/ios/BUILD.gn (respectively removed from both
39 # location when it is removed).
41 v8_enable_gdbjit = false
42 v8_imminent_deprecation_warnings = false
44 # Don't include webrtc's builtin task queue implementation.
45 rtc_link_task_queue_impl = false
47 # Don't include the iLBC audio codec.
48 # TODO(bugs.webrtc.org/8396): Once WebRTC gets rid of its internal
49 # deps on codecs, we can remove this.
50 rtc_include_ilbc = false
52 # Changes some setup for the Crashpad build to set them to build against
53 # Chromium's zlib, base, etc.
54 crashpad_dependencies = "chromium"
56 # Override ANGLE's Vulkan dependencies.
57 angle_vulkan_headers_dir = "//third_party/vulkan-deps/vulkan-headers/src"
58 angle_vulkan_loader_dir = "//third_party/vulkan-deps/vulkan-loader/src"
59 angle_vulkan_tools_dir = "//third_party/vulkan-deps/vulkan-tools/src"
60 angle_vulkan_validation_layers_dir =
61 "//third_party/vulkan-deps/vulkan-validation-layers/src"
63 # Overwrite default args declared in the Fuchsia sdk
64 fuchsia_sdk_readelf_exec =
65 "//third_party/llvm-build/Release+Asserts/bin/llvm-readelf"
66 fuchsia_target_api_level = 9
68 devtools_visibility = [ "*" ]
71 # These are the targets to skip header checking by default. The files in targets
72 # matching these patterns (see "gn help label_pattern" for format) will not have
73 # their includes checked for proper dependencies when you run either
74 # "gn check" or "gn gen --check".
77 "//headless:headless_renderer", # 12 errors
78 "//headless:headless_shared_sources", # 2 errors
80 # //v8, https://crbug.com/v8/7330
81 "//v8/src/inspector:inspector", # 20 errors
82 "//v8/test/cctest:cctest_sources", # 15 errors
83 "//v8/test/unittests:inspector_unittests_sources", # 2 errors
84 "//v8:cppgc_base", # 1 error
85 "//v8:v8_internal_headers", # 11 errors
86 "//v8:v8_libplatform", # 2 errors
88 # After making partition_alloc a standalone library, remove partition_alloc
89 # target from the skip list, because partition_aloc will depend on its own
91 # partition alloc standalone library bug is https://crbug.com/1151236.
92 "//base/allocator/partition_allocator:partition_alloc", # 292 errors
95 # These are the list of GN files that run exec_script. This whitelist exists
96 # to force additional review for new uses of exec_script, which is strongly
101 # You should almost never need to add new exec_script calls. exec_script is
102 # slow, especially on Windows, and can cause confusing effects. Although
103 # individually each call isn't slow or necessarily very confusing, at the scale
104 # of our repo things get out of hand quickly. By strongly pushing back on all
105 # additions, we keep the build fast and clean. If you think you need to add a
106 # new call, please consider:
108 # - Do not use a script to check for the existence of a file or directory to
109 # enable a different mode. Instead, use GN build args to enable or disable
110 # functionality and set options. An example is checking for a file in the
111 # src-internal repo to see if the corresponding src-internal feature should
112 # be enabled. There are several things that can go wrong with this:
114 # - It's mysterious what causes some things to happen. Although in many cases
115 # such behavior can be conveniently automatic, GN optimizes for explicit
116 # and obvious behavior so people can more easily diagnose problems.
118 # - The user can't enable a mode for one build and not another. With GN build
119 # args, the user can choose the exact configuration of multiple builds
120 # using one checkout. But implicitly basing flags on the state of the
121 # checkout, this functionality is broken.
123 # - It's easy to get stale files. If for example the user edits the gclient
124 # to stop checking out src-internal (or any other optional thing), it's
125 # easy to end up with stale files still mysteriously triggering build
126 # conditions that are no longer appropriate (yes, this happens in real
129 # - Do not use a script to iterate files in a directory (glob):
131 # - This has the same "stale file" problem as the above discussion. Various
132 # operations can leave untracked files in the source tree which can cause
133 # surprising effects.
135 # - It becomes impossible to use "git grep" to find where a certain file is
136 # referenced. This operation is very common and people really do get
137 # confused when things aren't listed.
139 # - It's easy to screw up. One common case is a build-time script that packs
140 # up a directory. The author notices that the script isn't re-run when the
141 # directory is updated, so adds a glob so all the files are listed as
142 # inputs. This seems to work great... until a file is deleted. When a
143 # file is deleted, all the inputs the glob lists will still be up to date
144 # and no command-lines will have been changed. The action will not be
145 # re-run and the build will be broken. It is possible to get this correct
146 # using glob, and it's possible to mess it up without glob, but globs make
147 # this situation much easier to create. if the build always lists the
148 # files and passes them to a script, it will always be correct.
150 exec_script_whitelist =
151 build_dotfile_settings.exec_script_whitelist +
152 angle_dotfile_settings.exec_script_whitelist +
154 # Whitelist entries for //build should go into
155 # //build/dotfile_settings.gni instead, so that they can be shared
156 # with other repos. The entries in this list should be only for files
157 # in the Chromium repo outside of //build.
158 "//build_overrides/build.gni",
160 "//chrome/android/webapk/shell_apk/prepare_upload_dir/BUILD.gn",
161 "//chrome/version.gni",
163 # TODO(dgn): Layer violation but breaks the build otherwise, see
164 # https://crbug.com/474506.
165 "//clank/java/BUILD.gn",
166 "//clank/native/BUILD.gn",
168 "//google_apis/BUILD.gn",
169 "//printing/BUILD.gn",
171 "//remoting/host/installer/linux/BUILD.gn",
172 "//remoting/remoting_version.gni",
173 "//remoting/host/installer/win/generate_clsids.gni",
175 "//tizen_src/ewk/efl_integration/BUILD.gn",
177 "//tools/grit/grit_rule.gni",
178 "//tools/gritsettings/BUILD.gn",