对多个项目和配置有效地使用VisualStudio项目属性

我刚刚发现了一些我认为不可能的事情(它没有被GUI公开),这有助于使属性表更加有用。项目属性文件中许多标记的“Condition”属性,它也可以在.props文件中使用!

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup Label="UserMacros">
    <!--debug suffix-->
    <DebugSuffix Condition="'$(Configuration)'=='Debug'">-d</DebugSuffix>
    <DebugSuffix Condition="'$(Configuration)'!='Debug'"></DebugSuffix>
    <!--platform-->
    <ShortPlatform Condition="'$(Platform)' == 'Win32'">x86</ShortPlatform>
    <ShortPlatform Condition="'$(Platform)' == 'x64'">x64</ShortPlatform>
    <!--toolset-->
    <Toolset Condition="'$(PlatformToolset)' == 'v90'">vc90</Toolset>
    <Toolset Condition="'$(PlatformToolset)' == 'v100'">vc100</Toolset>
  </PropertyGroup>
  <!--target-->
  <PropertyGroup>
    <TargetName>$(ProjectName)-$(Toolset)-$(ShortPlatform)$(DebugSuffix)</TargetName>
  </PropertyGroup>
</Project>

唯一的问题是属性GUI无法处理它,使用上述属性表的项目只报告默认继承值,如目标的“$(ProjectName)”。

我做了一些改进,可能对某些人有用

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup Label="UserMacros">
    <!--IsDebug: search for 'Debug' in Configuration-->
    <IsDebug>$([System.Convert]::ToString( $([System.Text.RegularExpressions.Regex]::IsMatch($(Configuration), '[Dd]ebug'))))</IsDebug>

    <!--ShortPlatform-->
    <ShortPlatform Condition="'$(Platform)' == 'Win32'">x86</ShortPlatform>
    <ShortPlatform Condition="'$(Platform)' == 'x64'">x64</ShortPlatform>

    <!--build parameters-->
    <BUILD_DIR>$(registry:HKEY_CURRENT_USER\Software\MyCompany\@BUILD_DIR)</BUILD_DIR>
  </PropertyGroup>

  <Choose>
    <When Condition="$([System.Convert]::ToBoolean($(IsDebug)))">
      <!-- debug macroses -->
      <PropertyGroup Label="UserMacros">
        <MyOutDirBase>Debug</MyOutDirBase>
        <DebugSuffix>-d</DebugSuffix>
      </PropertyGroup>
    </When>
    <Otherwise>
      <!-- other/release macroses -->
      <PropertyGroup Label="UserMacros">
        <MyOutDirBase>Release</MyOutDirBase>
        <DebugSuffix></DebugSuffix>
      </PropertyGroup>
    </Otherwise>
  </Choose>

  <Choose>
    <When Condition="Exists($(BUILD_DIR))">
      <PropertyGroup Label="UserMacros">
        <MyOutDir>$(BUILD_DIR)\Bin\$(MyOutDirBase)_$(ShortPlatform)\</MyOutDir>
        <MyIntDir>$(BUILD_DIR)\Build\$(Configuration)_$(ShortPlatform)_$(PlatformToolset)\$(ProjectGuid)\</MyIntDir>
      </PropertyGroup>
    </When>
    <Otherwise>
      <PropertyGroup Label="UserMacros">
        <MyOutDir>$(SolutionDir)\Bin\$(MyOutDirBase)_$(ShortPlatform)\</MyOutDir>
        <MyIntDir>$(SolutionDir)\Build\$(Configuration)_$(ShortPlatform)_$(PlatformToolset)\$(ProjectGuid)\</MyIntDir>
      </PropertyGroup>
    </Otherwise>
  </Choose>

  <PropertyGroup>
    <OutDir>$(MyOutDir)</OutDir>
    <IntDir>$(MyIntDir)</IntDir>
<!-- some common for projects
    <CharacterSet>Unicode</CharacterSet>
    <LinkIncremental>false</LinkIncremental>
--> 
  </PropertyGroup>
</Project>

以前我对公司的产品(200多个项目)也有同样的痛苦。我解决这个问题的方法是建立一个很好的属性表层次结构。

<VisualStudioPropertySheet
    ProjectType="Visual C++"
    Version="8.00"
    Name="x64.Debug.Dynamic.Binary"
    InheritedPropertySheets=".\Common.vsprops;.\x64.vsprops;.\Debug.vsprops;.\Runtime.Debug.Dynamic.vsprops;.\Output.x64.Library.vsprops"
    >

您还可以在属性表中使用变量(即UserMacro,其值可以是绝对值,甚至可以是环境变量),根据您的需要自定义许多内容。例如,在中定义BIN变量调试.vsprops

<UserMacro name="BIN" Value="Debug" />

<VisualStudioPropertySheet
    ProjectType="Visual C++"
    Version="8.00"
    OutputDirectory="$(BIN)"
>

$(BIN)变量将扩展到已设置的内容(在本例中为Debug)。使用此技术,您可以轻松地构建一个良好的属性表层次结构,以满足您的需求。

现在您可能还想做一件事:构建使用属性表集的自己的项目模板。真正困难的部分是强制正确使用模板和属性表。我个人的经验是,即使一切都设置好了,有人还是会忘记使用模板来创建新项目。。。

2. 打开属性管理器
3. 配置 (不是要修改的项目)
4. 单击“添加现有属性表”并添加您的表

对于输出库,您可以选择所有项目,然后打开属性页,选择所有配置、所有平台,然后将目标名称设置为:

$(ProjectName)-$(PlatformToolset)-$(PlatformShortName)-$(Configuration)

这将产生类似mylib-v100-x86的输出-调试.lib

$(PlatformName) 和 #(Configuration) 选择正确的库路径,尽管这确实意味着在库的初始设置上有些混乱。我们已经把它的libs安装到 boost/lib.Win32 boost/lib.x64 .

想到的另一个选择是在每个用户机器上设置一个环境变量,该变量指向他们的libraries文件夹的根,例如 LIB_ROOT=c:\libraries $(LIB_ROOT) .

这听起来像是一个值得检查的构建工具-在我的地方,我们使用一个定制的工具,监视文件和项目的变化,并数字的依赖关系和编译顺序。添加新文件没什么大不了的-编译是用msbuild完成的。

如果我要编译更多的项目,我会使用nant: http://nant.sourceforge.net/