295 lines
12 KiB
Python
295 lines
12 KiB
Python
"""engine.SCons.Tool.msvc
|
|
|
|
Tool-specific initialization for Microsoft Visual C/C++.
|
|
|
|
There normally shouldn't be any need to import this module directly.
|
|
It will usually be imported through the generic SCons.Tool.Tool()
|
|
selection method.
|
|
|
|
"""
|
|
|
|
#
|
|
# Copyright (c) 2001 - 2017 The SCons Foundation
|
|
#
|
|
# Permission is hereby granted, free of charge, to any person obtaining
|
|
# a copy of this software and associated documentation files (the
|
|
# "Software"), to deal in the Software without restriction, including
|
|
# without limitation the rights to use, copy, modify, merge, publish,
|
|
# distribute, sublicense, and/or sell copies of the Software, and to
|
|
# permit persons to whom the Software is furnished to do so, subject to
|
|
# the following conditions:
|
|
#
|
|
# The above copyright notice and this permission notice shall be included
|
|
# in all copies or substantial portions of the Software.
|
|
#
|
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
|
|
# KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
|
|
# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
#
|
|
|
|
__revision__ = "src/engine/SCons/Tool/msvc.py 74b2c53bc42290e911b334a6b44f187da698a668 2017/11/14 13:16:53 bdbaddog"
|
|
|
|
import os.path
|
|
import re
|
|
import sys
|
|
|
|
import SCons.Action
|
|
import SCons.Builder
|
|
import SCons.Errors
|
|
import SCons.Platform.win32
|
|
import SCons.Tool
|
|
import SCons.Tool.msvs
|
|
import SCons.Util
|
|
import SCons.Warnings
|
|
import SCons.Scanner.RC
|
|
|
|
from .MSCommon import msvc_exists, msvc_setup_env_once, msvc_version_to_maj_min
|
|
|
|
CSuffixes = ['.c', '.C']
|
|
CXXSuffixes = ['.cc', '.cpp', '.cxx', '.c++', '.C++']
|
|
|
|
def validate_vars(env):
|
|
"""Validate the PCH and PCHSTOP construction variables."""
|
|
if 'PCH' in env and env['PCH']:
|
|
if 'PCHSTOP' not in env:
|
|
raise SCons.Errors.UserError("The PCHSTOP construction must be defined if PCH is defined.")
|
|
if not SCons.Util.is_String(env['PCHSTOP']):
|
|
raise SCons.Errors.UserError("The PCHSTOP construction variable must be a string: %r"%env['PCHSTOP'])
|
|
|
|
def msvc_set_PCHPDBFLAGS(env):
|
|
"""
|
|
Set appropriate PCHPDBFLAGS for the MSVC version being used.
|
|
"""
|
|
if env.get('MSVC_VERSION',False):
|
|
maj, min = msvc_version_to_maj_min(env['MSVC_VERSION'])
|
|
if maj < 8:
|
|
env['PCHPDBFLAGS'] = SCons.Util.CLVar(['${(PDB and "/Yd") or ""}'])
|
|
else:
|
|
env['PCHPDBFLAGS'] = ''
|
|
else:
|
|
# Default if we can't determine which version of MSVC we're using
|
|
env['PCHPDBFLAGS'] = SCons.Util.CLVar(['${(PDB and "/Yd") or ""}'])
|
|
|
|
|
|
def pch_emitter(target, source, env):
|
|
"""Adds the object file target."""
|
|
|
|
validate_vars(env)
|
|
|
|
pch = None
|
|
obj = None
|
|
|
|
for t in target:
|
|
if SCons.Util.splitext(str(t))[1] == '.pch':
|
|
pch = t
|
|
if SCons.Util.splitext(str(t))[1] == '.obj':
|
|
obj = t
|
|
|
|
if not obj:
|
|
obj = SCons.Util.splitext(str(pch))[0]+'.obj'
|
|
|
|
target = [pch, obj] # pch must be first, and obj second for the PCHCOM to work
|
|
|
|
return (target, source)
|
|
|
|
def object_emitter(target, source, env, parent_emitter):
|
|
"""Sets up the PCH dependencies for an object file."""
|
|
|
|
validate_vars(env)
|
|
|
|
parent_emitter(target, source, env)
|
|
|
|
# Add a dependency, but only if the target (e.g. 'Source1.obj')
|
|
# doesn't correspond to the pre-compiled header ('Source1.pch').
|
|
# If the basenames match, then this was most likely caused by
|
|
# someone adding the source file to both the env.PCH() and the
|
|
# env.Program() calls, and adding the explicit dependency would
|
|
# cause a cycle on the .pch file itself.
|
|
#
|
|
# See issue #2505 for a discussion of what to do if it turns
|
|
# out this assumption causes trouble in the wild:
|
|
# http://scons.tigris.org/issues/show_bug.cgi?id=2505
|
|
if 'PCH' in env:
|
|
pch = env['PCH']
|
|
if str(target[0]) != SCons.Util.splitext(str(pch))[0] + '.obj':
|
|
env.Depends(target, pch)
|
|
|
|
return (target, source)
|
|
|
|
def static_object_emitter(target, source, env):
|
|
return object_emitter(target, source, env,
|
|
SCons.Defaults.StaticObjectEmitter)
|
|
|
|
def shared_object_emitter(target, source, env):
|
|
return object_emitter(target, source, env,
|
|
SCons.Defaults.SharedObjectEmitter)
|
|
|
|
pch_action = SCons.Action.Action('$PCHCOM', '$PCHCOMSTR')
|
|
pch_builder = SCons.Builder.Builder(action=pch_action, suffix='.pch',
|
|
emitter=pch_emitter,
|
|
source_scanner=SCons.Tool.SourceFileScanner)
|
|
|
|
|
|
# Logic to build .rc files into .res files (resource files)
|
|
res_scanner = SCons.Scanner.RC.RCScan()
|
|
res_action = SCons.Action.Action('$RCCOM', '$RCCOMSTR')
|
|
res_builder = SCons.Builder.Builder(action=res_action,
|
|
src_suffix='.rc',
|
|
suffix='.res',
|
|
src_builder=[],
|
|
source_scanner=res_scanner)
|
|
|
|
def msvc_batch_key(action, env, target, source):
|
|
"""
|
|
Returns a key to identify unique batches of sources for compilation.
|
|
|
|
If batching is enabled (via the $MSVC_BATCH setting), then all
|
|
target+source pairs that use the same action, defined by the same
|
|
environment, and have the same target and source directories, will
|
|
be batched.
|
|
|
|
Returning None specifies that the specified target+source should not
|
|
be batched with other compilations.
|
|
"""
|
|
|
|
# Fixing MSVC_BATCH mode. Previous if did not work when MSVC_BATCH
|
|
# was set to False. This new version should work better.
|
|
# Note we need to do the env.subst so $MSVC_BATCH can be a reference to
|
|
# another construction variable, which is why we test for False and 0
|
|
# as strings.
|
|
if not 'MSVC_BATCH' in env or env.subst('$MSVC_BATCH') in ('0', 'False', '', None):
|
|
# We're not using batching; return no key.
|
|
return None
|
|
t = target[0]
|
|
s = source[0]
|
|
if os.path.splitext(t.name)[0] != os.path.splitext(s.name)[0]:
|
|
# The base names are different, so this *must* be compiled
|
|
# separately; return no key.
|
|
return None
|
|
return (id(action), id(env), t.dir, s.dir)
|
|
|
|
def msvc_output_flag(target, source, env, for_signature):
|
|
"""
|
|
Returns the correct /Fo flag for batching.
|
|
|
|
If batching is disabled or there's only one source file, then we
|
|
return an /Fo string that specifies the target explicitly. Otherwise,
|
|
we return an /Fo string that just specifies the first target's
|
|
directory (where the Visual C/C++ compiler will put the .obj files).
|
|
"""
|
|
|
|
# Fixing MSVC_BATCH mode. Previous if did not work when MSVC_BATCH
|
|
# was set to False. This new version should work better. Removed
|
|
# len(source)==1 as batch mode can compile only one file
|
|
# (and it also fixed problem with compiling only one changed file
|
|
# with batch mode enabled)
|
|
if not 'MSVC_BATCH' in env or env.subst('$MSVC_BATCH') in ('0', 'False', '', None):
|
|
return '/Fo$TARGET'
|
|
else:
|
|
# The Visual C/C++ compiler requires a \ at the end of the /Fo
|
|
# option to indicate an output directory. We use os.sep here so
|
|
# that the test(s) for this can be run on non-Windows systems
|
|
# without having a hard-coded backslash mess up command-line
|
|
# argument parsing.
|
|
return '/Fo${TARGET.dir}' + os.sep
|
|
|
|
CAction = SCons.Action.Action("$CCCOM", "$CCCOMSTR",
|
|
batch_key=msvc_batch_key,
|
|
targets='$CHANGED_TARGETS')
|
|
ShCAction = SCons.Action.Action("$SHCCCOM", "$SHCCCOMSTR",
|
|
batch_key=msvc_batch_key,
|
|
targets='$CHANGED_TARGETS')
|
|
CXXAction = SCons.Action.Action("$CXXCOM", "$CXXCOMSTR",
|
|
batch_key=msvc_batch_key,
|
|
targets='$CHANGED_TARGETS')
|
|
ShCXXAction = SCons.Action.Action("$SHCXXCOM", "$SHCXXCOMSTR",
|
|
batch_key=msvc_batch_key,
|
|
targets='$CHANGED_TARGETS')
|
|
|
|
def generate(env):
|
|
"""Add Builders and construction variables for MSVC++ to an Environment."""
|
|
static_obj, shared_obj = SCons.Tool.createObjBuilders(env)
|
|
|
|
# TODO(batch): shouldn't reach in to cmdgen this way; necessary
|
|
# for now to bypass the checks in Builder.DictCmdGenerator.__call__()
|
|
# and allow .cc and .cpp to be compiled in the same command line.
|
|
static_obj.cmdgen.source_ext_match = False
|
|
shared_obj.cmdgen.source_ext_match = False
|
|
|
|
for suffix in CSuffixes:
|
|
static_obj.add_action(suffix, CAction)
|
|
shared_obj.add_action(suffix, ShCAction)
|
|
static_obj.add_emitter(suffix, static_object_emitter)
|
|
shared_obj.add_emitter(suffix, shared_object_emitter)
|
|
|
|
for suffix in CXXSuffixes:
|
|
static_obj.add_action(suffix, CXXAction)
|
|
shared_obj.add_action(suffix, ShCXXAction)
|
|
static_obj.add_emitter(suffix, static_object_emitter)
|
|
shared_obj.add_emitter(suffix, shared_object_emitter)
|
|
|
|
env['CCPDBFLAGS'] = SCons.Util.CLVar(['${(PDB and "/Z7") or ""}'])
|
|
env['CCPCHFLAGS'] = SCons.Util.CLVar(['${(PCH and "/Yu%s \\\"/Fp%s\\\""%(PCHSTOP or "",File(PCH))) or ""}'])
|
|
env['_MSVC_OUTPUT_FLAG'] = msvc_output_flag
|
|
env['_CCCOMCOM'] = '$CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS $CCPCHFLAGS $CCPDBFLAGS'
|
|
env['CC'] = 'cl'
|
|
env['CCFLAGS'] = SCons.Util.CLVar('/nologo')
|
|
env['CFLAGS'] = SCons.Util.CLVar('')
|
|
env['CCCOM'] = '${TEMPFILE("$CC $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $CFLAGS $CCFLAGS $_CCCOMCOM","$CCCOMSTR")}'
|
|
env['SHCC'] = '$CC'
|
|
env['SHCCFLAGS'] = SCons.Util.CLVar('$CCFLAGS')
|
|
env['SHCFLAGS'] = SCons.Util.CLVar('$CFLAGS')
|
|
env['SHCCCOM'] = '${TEMPFILE("$SHCC $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $SHCFLAGS $SHCCFLAGS $_CCCOMCOM","$SHCCCOMSTR")}'
|
|
env['CXX'] = '$CC'
|
|
env['CXXFLAGS'] = SCons.Util.CLVar('$( /TP $)')
|
|
env['CXXCOM'] = '${TEMPFILE("$CXX $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $CXXFLAGS $CCFLAGS $_CCCOMCOM","$CXXCOMSTR")}'
|
|
env['SHCXX'] = '$CXX'
|
|
env['SHCXXFLAGS'] = SCons.Util.CLVar('$CXXFLAGS')
|
|
env['SHCXXCOM'] = '${TEMPFILE("$SHCXX $_MSVC_OUTPUT_FLAG /c $CHANGED_SOURCES $SHCXXFLAGS $SHCCFLAGS $_CCCOMCOM","$SHCXXCOMSTR")}'
|
|
env['CPPDEFPREFIX'] = '/D'
|
|
env['CPPDEFSUFFIX'] = ''
|
|
env['INCPREFIX'] = '/I'
|
|
env['INCSUFFIX'] = ''
|
|
# env.Append(OBJEMITTER = [static_object_emitter])
|
|
# env.Append(SHOBJEMITTER = [shared_object_emitter])
|
|
env['STATIC_AND_SHARED_OBJECTS_ARE_THE_SAME'] = 1
|
|
|
|
env['RC'] = 'rc'
|
|
env['RCFLAGS'] = SCons.Util.CLVar('')
|
|
env['RCSUFFIXES']=['.rc','.rc2']
|
|
env['RCCOM'] = '$RC $_CPPDEFFLAGS $_CPPINCFLAGS $RCFLAGS /fo$TARGET $SOURCES'
|
|
env['BUILDERS']['RES'] = res_builder
|
|
env['OBJPREFIX'] = ''
|
|
env['OBJSUFFIX'] = '.obj'
|
|
env['SHOBJPREFIX'] = '$OBJPREFIX'
|
|
env['SHOBJSUFFIX'] = '$OBJSUFFIX'
|
|
|
|
# Set-up ms tools paths
|
|
msvc_setup_env_once(env)
|
|
|
|
env['CFILESUFFIX'] = '.c'
|
|
env['CXXFILESUFFIX'] = '.cc'
|
|
|
|
msvc_set_PCHPDBFLAGS(env)
|
|
|
|
|
|
env['PCHCOM'] = '$CXX /Fo${TARGETS[1]} $CXXFLAGS $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS /c $SOURCES /Yc$PCHSTOP /Fp${TARGETS[0]} $CCPDBFLAGS $PCHPDBFLAGS'
|
|
env['BUILDERS']['PCH'] = pch_builder
|
|
|
|
if 'ENV' not in env:
|
|
env['ENV'] = {}
|
|
if 'SystemRoot' not in env['ENV']: # required for dlls in the winsxs folders
|
|
env['ENV']['SystemRoot'] = SCons.Platform.win32.get_system_root()
|
|
|
|
def exists(env):
|
|
return msvc_exists()
|
|
|
|
# Local Variables:
|
|
# tab-width:4
|
|
# indent-tabs-mode:nil
|
|
# End:
|
|
# vim: set expandtab tabstop=4 shiftwidth=4:
|