如何将从文件读取的动态依赖项添加到MSBuild目标输入中？

我通过MSBuild的.targets文件实现了自定义构建流程，用自研转译器处理.myFile类型文件，原本运行正常。现在为文件添加动态引用支持后遇到问题：此前只需固定引用一个系统文件，直接加入Inputs即可；但现在转译器会为每个*.myFile生成对应的*.dep依赖文件，我需要将这些动态依赖信息传递给MSBuild，确保增量构建的正确性。

当前使用的.targets文件如下：

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <PropertyPageSchema Include="$(MSBuildThisFileDirectory)myFile.xml" />
    <AvailableItemName Include="MyFile">
      <Targets>MyFileConvert</Targets>
    </AvailableItemName>
  </ItemGroup>
  
  <PropertyGroup>
    <DisableFastUpToDateCheck>true</DisableFastUpToDateCheck>
  </PropertyGroup>

  <Target
    Name="MyFileConvert"
    Condition="'@(MyFile)'!=''"
    Inputs="$(MSBuildThisFileDirectory)\..\bin\Converter.exe;@(MyFile);$(SolutionDir)..\StdIncludes\Common.myFile"
    Outputs="@(MyFile->'%(RelativeDir)%(Filename).check');@(MyFile->'%(RelativeDir)%(Filename)-include.h')"
    BeforeTargets="PrepareForBuild"
  >
    <Message Importance="High" Text="Converting MyFile %(MyFile.Identity)..."/>
    <Exec
      Command="&quot;$(MSBuildThisFileDirectory)\..\bin\Converter.exe&quot; -build $(Configuration) -std &quot;$(SolutionDir)..\StdIncludes&quot; -file &quot;%(FullPath)&quot;"
      Outputs="%(MyFile.RelativeDir)%(MyFile.Filename).check;%(MyFile.RelativeDir)%(MyFile.Filename)-include.h"
    />
  </Target>  
</Project>

转译器会将*.myFile转换为*.check（内部审计用）和*-include.h（供C++编译使用），新增逻辑后还会输出*.dep依赖文件。我尝试过多种方法，但都存在问题：

尝试过的方法及问题 #

方法1：直接将.dep文件加入Target的Inputs #

<Target Inputs="@(MyFile->'%(RelativeDir)%(Filename).dep');[old inputs]" ... >

结果：触发错误MSB4012，提示项列表无法与其他字符串拼接，必须用分号分隔多个项列表。即使修正语法，第一次构建时.dep文件不存在，MSBuild会忽略该输入，后续.dep变更无法触发重建。

方法2：前置目标生成.dep路径属性 #

<Target Name="PrepareDepFileLookup">
  <PropertyGroup>
    <DepFilePath>@(MyFile->'%(RelativeDir)%(Filename).dep')</DepFilePath>
  </PropertyGroup>
</Target>

<Target Name="MyFileConvert" DependsOnTargets="PrepareDepFileLookup" Inputs="$(DepFilePath);[old inputs]" ... >

结果：无语法错误，但多文件时DepFilePath会拼接所有.dep路径，导致依赖混乱，无法实现单个文件的独立增量评估。

方法3：将.dep路径属性移至主Target内部 #

结果：Target内部DepFilePath值正确，但Inputs属性无法读取该值（MSBuild在评估目标前会解析Inputs/Outputs，此时Target内部的属性尚未初始化）。

方法4：使用CallTarget传递数据 #

结果：无法传递额外数据，不可行。

方法5：使用MSBuild任务调用目标并传递属性 #

结果：实际项目的.targets文件复杂，多值属性会导致配置混乱，暂不考虑。

方法6：前置目标为MyFile项追加依赖元数据 #

<Target Name="RetrieveDependencies" Inputs="@(MyFile)" Outputs="%(MyFile.Identity)-force-run">
  <Message Importance="High" Text="Reading: %(MyFile.RelativeDir)%(MyFile.Filename).dep" />
  <ReadLinesFromFile File="%(MyFile.RelativeDir)%(MyFile.Filename).dep">
    <Output TaskParameter="Lines" PropertyName="_Dependencies"/>
  </ReadLinesFromFile>
  <PropertyGroup>
    <MyFileName>%(MyFile.Identity)</MyFileName>
  </PropertyGroup>
  <ItemGroup>
    <MyFile Condition="'%(MyFile.Identity)'=='$(MyFileName)'">
      <Dependencies>$(_Dependencies)</Dependencies>
    </MyFile>
  </ItemGroup>  
</Target>

<Target Name="MyFileConvert" DependsOnTargets="RetrieveDependencies" Inputs="@(MyFile->'%(Dependencies)');[old inputs]" ... >

结果：能读取依赖项，但Outputs="%(MyFile.Identity)-force-run"指定的文件不存在，导致该目标每次都会强制运行，进而触发所有.myFile文件重新编译。

方法7：直接访问项的Metadata #

<Target Name="MyFileConvert" DependsOnTargets="PrepareDepFileLookup" Inputs="@(MyFile.Metadata('Dependencies'));[old inputs]" ... >

结果：与方法6问题一致，强制全部重建。

正确解决方案 #

核心思路是按单个文件独立评估增量，并在转译前读取已存在的.dep文件，将依赖项附加到对应MyFile项的元数据中，同时跟踪.dep文件本身的生成。修改后的.targets代码如下：

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <PropertyPageSchema Include="$(MSBuildThisFileDirectory)myFile.xml" />
    <AvailableItemName Include="MyFile">
      <Targets>MyFileConvert</Targets>
    </AvailableItemName>
  </ItemGroup>
  
  <PropertyGroup>
    <DisableFastUpToDateCheck>true</DisableFastUpToDateCheck>
  </PropertyGroup>

  <!-- 前置目标：读取已生成的.dep文件，为每个MyFile项添加依赖元数据 -->
  <Target Name="CollectMyFileDependencies"
          BeforeTargets="MyFileConvert"
          Inputs="@(MyFile)"
          Outputs="%(MyFile.RelativeDir)%(MyFile.Filename).dep">
    <!-- 仅当.dep文件存在时读取内容 -->
    <ReadLinesFromFile File="%(MyFile.RelativeDir)%(MyFile.Filename).dep"
                       Condition="Exists('%(MyFile.RelativeDir)%(MyFile.Filename).dep')">
      <Output TaskParameter="Lines" ItemName="_MyFileDependencies" />
    </ReadLinesFromFile>
    <!-- 将依赖项附加到对应的MyFile项 -->
    <ItemGroup>
      <MyFile>
        <AdditionalDependencies>@(_MyFileDependencies)</AdditionalDependencies>
      </MyFile>
    </ItemGroup>
    <!-- 清空临时项组，避免跨文件污染 -->
    <ItemGroup>
      <_MyFileDependencies Remove="@(_MyFileDependencies)" />
    </ItemGroup>
  </Target>

  <!-- 修改后的转换目标，按单个文件评估增量 -->
  <Target Name="MyFileConvert"
          Condition="'@(MyFile)' != ''"
          Inputs="$(MSBuildThisFileDirectory)\..\bin\Converter.exe;
                  %(MyFile.Identity);
                  $(SolutionDir)..\StdIncludes\Common.myFile;
                  %(MyFile.AdditionalDependencies)"
          Outputs="%(MyFile.RelativeDir)%(MyFile.Filename).check;
                   %(MyFile.RelativeDir)%(MyFile.Filename)-include.h;
                   %(MyFile.RelativeDir)%(MyFile.Filename).dep"
          BeforeTargets="PrepareForBuild"
          Returns="@(MyFile->'%(RelativeDir)%(Filename)-include.h')">
    
    <Message Importance="High" Text="Converting MyFile %(MyFile.Identity)..."/>
    
    <Exec Command="&quot;$(MSBuildThisFileDirectory)\..\bin\Converter.exe&quot; -build $(Configuration) -std &quot;$(SolutionDir)..\StdIncludes&quot; -file &quot;%(MyFile.FullPath)&quot;"
          Outputs="%(MyFile.RelativeDir)%(MyFile.Filename).check;%(MyFile.RelativeDir)%(MyFile.Filename)-include.h;%(MyFile.RelativeDir)%(MyFile.Filename).dep"/>
  </Target>  
</Project>

方案关键点说明 #

1. 按单个文件评估增量：MyFileConvert目标的Inputs/Outputs使用%(MyFile.Identity)作为批量标识，MSBuild会为每个MyFile项单独计算是否需要重建，避免多文件相互干扰。
2. 依赖文件读取逻辑：CollectMyFileDependencies目标仅当.dep文件存在时读取内容，将依赖项作为AdditionalDependencies元数据附加到对应MyFile项；目标的Outputs设为.dep文件，仅当.dep变更时才会重新读取，避免不必要的执行。
3. 跟踪.dep文件本身：MyFileConvert的Outputs新增了.dep文件，因为转译器会生成它，MSBuild会跟踪该文件的变更，确保依赖链完整。
4. 避免跨文件污染：读取依赖后清空临时项组_MyFileDependencies，防止不同文件的依赖项相互覆盖。

这样修改后，每个.myFile文件的增量构建会独立触发：当文件自身、依赖的.dep内容、系统文件或转译器变更时，才会执行转译，不会强制全部重建。

内容的提问来源于stack exchange，提问作者Carl Colijn