# Copyright (c) 2013 The Chromium Authors. All rights reserved. # Use of this source code is governed by a BSD-style license that can be # found in the LICENSE file. # ============================================================================= # BUILD FLAGS # ============================================================================= # # This block lists input arguments to the build, along with their default # values. GN requires listing them explicitly so it can validate input and have # a central place to manage the build flags. # # If a value is specified on the command line, it will overwrite the defaults # given here, otherwise the default will be injected into the root scope. # # KEEP IN ALPHABETICAL ORDER and write a good description for everything. # Use "is_*" names for intrinsic platform descriptions and build modes, and # "use_*" names for optional features libraries, and configurations. declare_args() { # How many symbols to include in the build. This affects the performance of # the build since the symbols are large and dealing with them is slow. # 2 means regular build with symbols. # 1 means minimal symbols, usually enough for backtraces only. # 0 means no symbols. symbol_level = 2 # Component build. is_component_build = false # Debug build. is_debug = true # Set to true when compiling with the Clang compiler. Typically this is used # to configure warnings. is_clang = false # ASH is enabled. # TODO(brettw) this should be moved out of the main build config file. use_ash = false # Aura is enabled. # TODO(brettw) this should be moved out of the main build config file. use_aura = false # Ozone is enabled. # TODO(brettw) this should be moved out of the main build config file. use_ozone = false # Forces a 64-bit build on Windows. Does nothing on other platforms. Normally # we build 32-bit on Windows regardless of the current host OS bit depth. # Setting this flag will override this logic and generate 64-bit toolchains. # # Normally this would get set automatically when you specify a target using # the 64-bit toolchain. You can also set this on the command line to convert # the default toolchain to 64-bit. force_win64 = false # Set to true on the command line when invoked by GYP. Build files can key # off of this to make any GYP-output-specific changes to the build. is_gyp = false } # ============================================================================= # OS DEFINITIONS # ============================================================================= # # We set these various is_FOO booleans for convenience in writing OS-based # conditions. # # - is_android, is_chromeos, is_ios, and is_win should be obvious. # - is_mac is set only for desktop Mac. It is not set on iOS. # - is_posix is true for mac and any Unix-like system (basically everything # except Windows). # - is_linux is true for any Linux variant including Android and ChromeOS. # # Do not add more is_* variants here for random lesser-used Unix systems like # aix or one of the BSDs. If you need to check these, just check the os value # directly. if (os == "win") { is_android = false is_chromeos = false is_ios = false is_linux = false is_mac = false is_nacl = false is_posix = false is_win = true } else if (os == "mac") { is_android = false is_chromeos = false is_ios = false is_linux = false is_mac = true is_nacl = false is_posix = true is_win = false is_clang = true # Always use clang on Mac. } else if (os == "android") { is_android = false is_chromeos = false is_ios = false is_linux = true is_mac = false is_nacl = false is_posix = true is_win = false } else if (os == "chromeos") { is_android = false is_chromeos = true is_ios = false is_linux = true is_mac = false is_nacl = false is_posix = true is_win = false } else if (os == "nacl") { # os == "nacl" will be passed by the nacl toolchain definition. It is not # set by default or on the command line. We treat is as a Posix variant. is_android = false is_chromeos = false is_ios = false is_linux = false is_mac = false is_nacl = true is_posix = true is_win = false } else if (os == "ios") { is_android = false is_chromeos = false is_ios = true is_linux = false is_mac = false is_nacl = false is_posix = true is_win = false } else if (os == "linux") { is_android = false is_chromeos = false is_ios = false is_linux = true is_mac = false is_nacl = false is_posix = true is_win = false } # ============================================================================= # CPU ARCHITECTURE # ============================================================================= if (is_win) { # Always use 32-bit on Windows, even when compiling on a 64-bit host OS, # unless the override flag is specified. if (force_win64) { cpu_arch = "ia64" } else { cpu_arch = "ia32" } } # ============================================================================= # SOURCES FILTERS # ============================================================================= # # These patterns filter out platform-specific files when assigning to the # sources variable. The magic variable |sources_assignment_filter| is applied # to each assignment or appending to the sources variable and matches are # automatcally removed. # # We define lists of filters for each platform for all builds so they can # be used by individual targets if necessary (a target can always change # sources_assignment_filter on itself if it needs something more specific). # # Note that the patterns are NOT regular expressions. Only "*" and "\b" (path # boundary = end of string or slash) are supported, and the entire string # muct match the pattern (so you need "*.cc" to match all .cc files, for # example). windows_sources_filters = [ "*_win.cc", "*_win.h", "*_win_unittest.cc", "*\bwin/*", ] mac_sources_filters = [ "*_mac.h", "*_mac.cc", "*_mac.mm", "*_mac_unittest.h", "*_mac_unittest.cc", "*_mac_unittest.mm", "*\bmac/*", "*_cocoa.h", "*_cocoa.cc", "*_cocoa.mm", "*_cocoa_unittest.h", "*_cocoa_unittest.cc", "*_cocoa_unittest.mm", "*\bcocoa/*", ] ios_sources_filters = [ "*_ios.h", "*_ios.cc", "*_ios.mm", "*_ios_unittest.h", "*_ios_unittest.cc", "*_ios_unittest.mm", "*\bios/*", ] objective_c_sources_filters = [ "*.mm", ] linux_sources_filters = [ "*_linux.h", "*_linux.cc", "*_linux_unittest.h", "*_linux_unittest.cc", "*\blinux/*", "*_x11.cc", "*_x11.h", ] android_sources_filters = [ "*_android.h", "*_android.cc", "*_android_unittest.h", "*_android_unittest.cc", "*\bandroid/*", ] posix_sources_filters = [ "*_posix.h", "*_posix.cc", "*_posix_unittest.h", "*_posix_unittest.cc", "*\bposix/*", ] # Construct the full list of sources we're using for this platform. sources_assignment_filter = [] if (is_win) { sources_assignment_filter += posix_sources_filters } else { sources_assignment_filter += windows_sources_filters } if (!is_mac) { sources_assignment_filter += mac_sources_filters } if (!is_ios) { sources_assignment_filter += ios_sources_filters } if (!is_mac && !is_ios) { sources_assignment_filter += objective_c_sources_filters } if (!is_linux) { sources_assignment_filter += linux_sources_filters } if (!is_android) { sources_assignment_filter += android_sources_filters } # This is the actual set. set_sources_assignment_filter(sources_assignment_filter) # ============================================================================= # BUILD OPTIONS # ============================================================================= if (is_component_build) { component_mode = "shared_library" } else { component_mode = "static_library" } toolkit_uses_gtk = is_linux # ============================================================================= # TARGET DEFAULTS # ============================================================================= # # Set up the default configuration for every build target of the given type. # The values configured here will be automatically set on the scope of the # corresponding target. Target definitions can add or remove to the settings # here as needed. # Holds all configs used for making native executables and libraries, to avoid # duplication in each target below. native_compiler_configs = [ "//build/config:my_msvs", # TODO(brettw) eraseme "//build/config/compiler:compiler", "//build/config/compiler:chromium_code", "//build/config/compiler:default_warnings", "//build/config/compiler:no_rtti", "//build/config/compiler:runtime_library", ] if (is_win) { native_compiler_configs += [ "//build/config/win:sdk", ] } else if (is_clang) { native_compiler_configs += "//build/config/clang:find_bad_constructs" } # Optimizations and debug checking. if (is_debug) { native_compiler_configs += "//build/config:debug" default_optimization_config = "//build/config/compiler:no_optimize" } else { native_compiler_configs += "//build/config:release" default_optimization_config = "//build/config/compiler:optimize" } native_compiler_configs += default_optimization_config # Symbol setup. if (is_clang && (is_linux || is_android)) { # Clang creates chubby debug information, which makes linking very slow. # For now, don't create debug information with clang. # See http://crbug.com/70000 # TODO(brettw) This just copies GYP. Why not do this on Mac as well? default_symbols_config = "//build/config/compiler:no_symbols" } else if (symbol_level == 2) { default_symbols_config = "//build/config/compiler:symbols" } else if (symbol_level == 1) { default_symbols_config = "//build/config/compiler:minimal_symbols" } else if (symbol_level == 0) { default_symbols_config = "//build/config/compiler:no_symbols" } else { assert(false, "Bad value for symbol_level.") } native_compiler_configs += default_symbols_config # Windows linker setup for EXEs and DLLs. if (is_win) { if (is_debug) { default_incremental_linking_config = "//build/config/win:incremental_linking" } else { default_incremental_linking_config = "//build/config/win:no_incremental_linking" } windows_linker_configs = [ default_incremental_linking_config, "//build/config/win:sdk_link", "//build/config/win:common_linker_setup", # Default to console-mode apps. Most of our targets are tests and such # that shouldn't use the windows subsystem. "//build/config/win:console", ] } set_defaults("executable") { configs = native_compiler_configs if (is_win) { configs += windows_linker_configs } else if (is_mac) { configs += "//build/config/mac:mac_dynamic_flags" } else if (is_linux) { configs += "//build/config/linux:executable_ldconfig" } } set_defaults("static_library") { configs = native_compiler_configs } set_defaults("shared_library") { configs = native_compiler_configs if (is_win) { configs += windows_linker_configs } else if (is_mac) { configs += "//build/config/mac:mac_dynamic_flags" } } set_defaults("source_set") { configs = native_compiler_configs } # ============================================================================== # TOOLCHAIN SETUP # ============================================================================== # # Here we set the default toolchain, as well as the variable host_toolchain # which will identify the toolchain corresponding to the local system when # doing cross-compiles. When not cross-compiling, this will be the same as the # default toolchain. if (is_win) { if (cpu_arch == "ia64") { host_toolchain = "//build/toolchain/win:64" } else if (cpu_arch == "ia32") { host_toolchain = "//build/toolchain/win:32" } set_default_toolchain(host_toolchain) } else if (is_linux) { host_toolchain = "//build/toolchain/linux:host" if (cpu_arch == "arm" && build_cpu_arch != "arm") { # Special toolchain for ARM cross-compiling. set_default_toolchain("//build/toolchain/linux:arm-cross-compile") } else { # Use whatever GCC is on the current platform. set_default_toolchain(host_toolchain) } } else if (is_mac) { host_toolchain = "//build/toolchain/mac:clang" set_default_toolchain(host_toolchain) }