如何转储从 MSBuild 导入的属性表列表

Question

我正在构建属性表的层次结构（许多属性表是根据平台和配置有条件包含的），并且我正在尝试编写一组目标来帮助诊断可能潜入的任何错误。

我想要的是属性列表已包含的表。

示例：

<ImportGroup Condition="$(Configuration.Contains('Debug'))">
  <Import Project="ps.cpp.config.debug.props"/>
</ImportGroup>
<ImportGroup Condition="$(Configuration.Contains('Release'))">
  <Import Project="ps.cpp.config.release.props"/>
</ImportGroup>

<ImportGroup Condition="'$(Platform)' == 'x64'">
  <Import Project="ps.cpp.plat.x64.props"/>
</ImportGroup>
<ImportGroup Condition="'$(Platform)' == 'Win32'">
  <Import Project="ps.cpp.plat.win32.props"/>
</ImportGroup>

像这样的目标：

<Target Name="DumpPropertySheets">
  <!-- This doesn't work! -->
  <!-- <Message Text="%(Import.Project)"/> -->
</Target>

使用 msbuild test.vcxproj /t:DumpPropertySheets /p:Platform=x64 /p:Configuration:Debug 构建时，应该会产生这样的控制台输出

DumpPropertySheets:
  ps.cpp.config.debug.props
  ps.cpp.plat.x64.props

Answer 1

没有一种明显的方法可以完成您想要做的事情。导入经过预处理，将所有内容聚合到一个文件中，它们不是像项目数组或属性这样可以稍后引用的数据类型。

语法 %(Import.Project) 不起作用，因为该语法仅对项目数组有效，并且您尝试在 Import 关键字上使用它，该关键字不是填充的项目数组。

另请注意，您对导入周围的 ImportGroup 元素的使用是可选的（并且可能有点冗长）。 MSBuild 文件中的以下两个构造是等效的...

<ImportGroup Condition="$(Configuration.Contains('Debug'))">
   <Import Project="ps.cpp.config.debug.props"/>
</ImportGroup> 

...并且（为了清楚起见，换行）...

<Import
   Condition="$(Configuration.Contains('Debug'))"
   Project="ps.cpp.config.debug.props" 
   />

如果您尝试诊断属性表导入错误，请不要忘记 /pp 命令行开关，这将转储完整的预处理文件。您还可以（至少对于您自己的文件）为每个导入提供一个唯一的条目到项目数组中，例如

<Import
   Condition="$(Configuration.Contains('Debug'))"
   Project="ps.cpp.config.debug.props" 
   />

然后在 ps.cpp.config.debug.props 内，

<ItemGroup>
   <_Import Include="$(MSBuildThisFile)" />
</ItemGroup>

然后在您的构建中稍后您可以得到在某种程度上，你似乎正在寻找什么，

<Target Name="DumpPropertySheets">
   <!-- This does work! -->
   <Message Text="%(_Import.Identity)" />
</Target>