• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Copyright 2015 The Chromium Authors
2# Use of this source code is governed by a BSD-style license that can be
3# found in the LICENSE file.
4
5# Toolchain-related configuration that may be needed outside the context of the
6# toolchain() rules themselves.
7
8import("//build/config/cast.gni")
9import("//build/config/chrome_build.gni")
10import("//build_overrides/build.gni")
11
12declare_args() {
13  # If this is set to true, we use the revision in the llvm repo to determine
14  # the CLANG_REVISION to use, instead of the version hard-coded into
15  # //tools/clang/scripts/update.py. This should only be used in
16  # conjunction with setting the llvm_force_head_revision DEPS variable when
17  # `gclient runhooks` is run as well.
18  llvm_force_head_revision = false
19
20  # Cronet is shipped in AOSP, where it is built using the Android Mainline
21  # Clang. Please refer to go/cronet-builders-with-mainline-clang-design for
22  # more information.
23  # If this arg is set to true, we use the Android Mainline LLVM.
24  llvm_android_mainline = false
25
26  # Used for binary size analysis.
27  generate_linker_map = is_android && is_official_build
28
29  # Whether this toolchain is to be used for building host tools that are
30  # consumed during the build process. That includes proc macros and Cargo build
31  # scripts.
32  toolchain_for_rust_host_build_tools = false
33}
34
35if (generate_linker_map) {
36  assert(is_official_build || is_castos || is_cast_android,
37         "Linker map files should only be generated when is_official_build = " +
38             "true or is_castos = true or is_cast_android = true")
39  assert(current_os == "android" || current_os == "linux" ||
40             target_os == "android" || target_os == "linux" ||
41             target_os == "chromeos",
42         "Linker map files should only be generated for Android, Linux, " +
43             "or ChromeOS.")
44}
45
46declare_args() {
47  if (llvm_android_mainline) {  # https://crbug.com/1481060
48    clang_version = "17"
49  } else {
50    clang_version = "18"
51  }
52}
53
54# Extension for shared library files (including leading dot).
55if (is_apple) {
56  shlib_extension = ".dylib"
57} else if (is_android && is_component_build) {
58  # By appending .cr, we prevent name collisions with libraries already
59  # loaded by the Android zygote.
60  shlib_extension = ".cr.so"
61} else if (is_posix || is_fuchsia) {
62  shlib_extension = ".so"
63} else if (is_win) {
64  shlib_extension = ".dll"
65} else {
66  assert(false, "Platform not supported")
67}
68
69# Same extension but for the host platform. We have significantly fewer host
70# platforms.
71if (host_os == "mac") {
72  host_shlib_extension = ".dylib"
73} else if (host_os == "win") {
74  host_shlib_extension = ".dll"
75} else if (host_os == "linux" || host_os == "aix") {
76  host_shlib_extension = ".so"
77} else {
78  assert(false, "Host platform not supported")
79}
80
81# Prefix for shared library files.
82if (is_posix || is_fuchsia) {
83  shlib_prefix = "lib"
84} else {
85  shlib_prefix = ""
86}
87
88# Directory for shared library files.
89if (is_fuchsia) {
90  shlib_subdir = "/lib"
91} else {
92  shlib_subdir = ""
93}
94
95# While other "tool"s in a toolchain are specific to the target of that
96# toolchain, the "stamp" and "copy" tools are really generic to the host;
97# but each toolchain must define them separately.  GN doesn't allow a
98# template instantiation inside a toolchain definition, so some boilerplate
99# has to be repeated in each toolchain to define these two tools.  These
100# four variables reduce the duplication in that boilerplate.
101stamp_description = "STAMP {{output}}"
102copy_description = "COPY {{source}} {{output}}"
103if (host_os == "win") {
104  _tool_wrapper_path =
105      rebase_path("//build/toolchain/win/tool_wrapper.py", root_build_dir)
106
107  stamp_command = "cmd /c type nul > \"{{output}}\""
108  copy_command = "\"$python_path\" $_tool_wrapper_path recursive-mirror {{source}} {{output}}"
109} else {
110  stamp_command = "touch {{output}}"
111  copy_command = "ln -f {{source}} {{output}} 2>/dev/null || (rm -rf {{output}} && cp -af {{source}} {{output}})"
112}
113
114# This variable is true if the current toolchain is one of the target
115# toolchains, i.e. a toolchain which is being used to build the main Chrome
116# binary. This generally means "not the host toolchain", but in the case where
117# we're targeting the host it's true then as well. We do require current_os to
118# match target_os so that for example we avoid considering Android as a target
119# toolchain when targeting CrOS.
120is_a_target_toolchain =
121    (current_toolchain != host_toolchain ||
122     default_toolchain == host_toolchain) && current_os == target_os
123