.gn

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