【Visual Studio】之Visual Studio工程文件解析

之前做过VS工程文件解析，一直没做相关总结

借助前人之手，觉得总结得很好，故贴了过来

原文：https://www.cnblogs.com/WonKerr/archive/2010/06/27/VS2010_VCXPROJ_2.html

其他：https://cloud.tencent.com/info/af87ed5ce6ac2c9a1453bcb9939b70ce.html

           https://blog.csdn.net/u010977122/article/details/79115873

https://www.cnblogs.com/yaozhongxiao/p/3477308.html

https://www.cnblogs.com/WonKerr/archive/2010/06/27/VS2010_VCXPROJ_1.html

https://blog.csdn.net/u012175089/article/details/55050617/

1、在 PropertyGroup 元素中放置子元素就是定义属性，属性的值就是子元素的内容；例如

<PropertyGroup>
<OutputDriver>D:\</OutputDriver>
</PropertyGroup>

定义来一个属性 OutputDriver 值为 D:\

2、定义元素时可以通过条件来让属性定义在特定的条件下起作用，例如：

<PropertyGroup>
<SingleFolder Condition="'$(SingleFolder)' == ''">false</SingleFolder>
</PropertyGroup>

只有当 SingleFolder 属性没有定义或者定义的值为空时，将 SingleFolder 的属性定义为 false ； 如果属性组中只有一个属性，或者一个属性组中的多个属性有相同的条件，则可以把条件放置到 PropertyGroup 元素中；

3、条件表达式可以使用 "=="、"!=" 进行判断，也可以对数值进行“>”、“>=”、“<”、“<=”判断，并且可以对目录进行“Exists”和“HasTrailingSlash”判断，同时可以对表达式进行 “!” 或对多个表达式进行 “AND”、“OR”等操作，可以参考 http://msdn.microsoft.com/en-us/library/7szfhaft.aspx  

4、值的定义可以进行继承，其实就是在原有的值的基础上增加新的值，如下所示：

<PropertyGroup Condition="Exists('$(ImportFolder)')">
<LibraryPath>$(ImportFolder);$(LibraryPath)</LibraryPath>
</PropertyGroup>

 

如果属性“ImportFolder”指定的目录存在，那么将该目录增加到“库”的搜索路径中，并且优先级在默认搜索路径的前面；

5、可以使用 .net 的函数进行判断或者属性值的定义，例如定义解决方案文件所在的驱动器可以使用如下的定义：

<PropertyGroup Condition="'$(SolutionDriver)' == ''" >
<SolutionDriver>$([System.IO.Path]::GetPathRoot($(SolutionDir)))</SolutionDriver>
</PropertyGroup>

 

6、可以使用 import 元素导入其他的属性设置文件，例如需要导入一个解决方案同名的属性文件：

<ImportGroup>
<Import Project="$(UserRootDir)\Microsoft.Cpp.Common.user.props" />
</ImportGroup>

 

说明：UserRootDir 是 C++ 默认属性文件中定义的属性，值为 $(LOCALAPPDATA)\Microsoft\MSBuild\v4.0\

 

7、如果导入的属性文件需要在 Visual Studio 2010 的 "属性管理器" (Property Manager)窗口中可以看到，那么在 ImportGroup 元素中增加特定的属性即可，如下所示：

<ImportGroup Label="PropertySheets">
<Import Project="$(ProjectPath).props" Condition="Exists('$(ProjectPath).props')" />
</ImportGroup>

 

则如果一个工程文件的目录下存在 .vcxproj.props 将导入该文件，例如工程文件为 MyProj.vcxproj 并且在工程目录下存在 MyProj.vcxproj.props文件则会自动导入文件 MyProj.vcxproj.props 属性文件

8、如果在 Property Manager 窗口中希望看到的属性文件名称不是文件名，而是自定的名称，那么可以再属性文件中增加一个特定的属性定义来实现，例如：

<PropertyGroup>
<_PropertySheetDisplayName>Cpp Common Properties</_PropertySheetDisplayName>
</PropertyGroup>

 

好了，基本规则我们已经掌握了（复杂的可以研究 VS2010 的 props 文件和查看 MSDN），下面来看看编译和链接的选项如何设置：

1、编译的选项放置在 ItemDefinitionGroup 元素的 ClCompile 子元素中，例如下面的定义：

 

<ItemDefinitionGroup>
<ClCompile>
<PreprocessorDefinitions>ISF_BUILD_DLL;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<PrecompiledHeaderFile>ISF/Stable_Headers.h</PrecompiledHeaderFile>
<PrecompiledHeader>Use</PrecompiledHeader>
</ClCompile>
</ItemDefinitionGroup>

在这个定义中，首先增加来一个宏定义“ISF_BUILD_DLL”，然后是定义预编译头文件的名称“ISF/Stable_Headers.h”，而不是默认的“stdafx.h”，最后定义来预编译头文件的使用规则是“使用预编译头文件”，这就要求所有的C/C++文件必须在最前面包含头文件 “ISF/Stable_Headers.h”，除非在文件上指定不使用预编译头文件；

2、链接的选项放置在 ItemDefinitionGroup 元素的 Link 子元素中，例如下面的定义：

<ItemDefinitionGroup>
<Link>
<ProgramDatabaseFile>$(SymbolFolder)$(OutputName).pdb</ProgramDatabaseFile>
<ImportLibrary>$(ImportFolder)$(OutputName).lib</ImportLibrary>
</Link>
</ItemDefinitionGroup>

在这个定义中，指定了输出的私有的 pdb 文件的输出全路径和动态库的导入库的输出全路径；

3、库的选项放置在 ItemDefinitionGroup 元素的 Lib 子元素中，例如下面的定义：

<ItemDefinitionGroup>
<Lib>
<LinkTimeCodeGeneration>true</LinkTimeCodeGeneration>
</Lib>
</ItemDefinitionGroup>

定义了静态库生成时的代码生成行为是“连接时代码生成”；