使用NoTargets SDK在VS中收集多项目输出打包NuGet遇依赖缺失问题

核心问题分析 #

1. 无自定义输出路径时无法自动获取输出：默认构建输出分散在各项目的bin目录，无法通过统一变量获取，导致打包时难以收集。
2. 指定输出路径后依赖丢失：单独给子项目指定OutDir会破坏MSBuild的依赖解析逻辑，依赖项目（如StandardHelpers）不会自动同步到自定义目录，导致主项目找不到依赖文件。

解决方案 #

通过统一所有项目的输出目录、自动构建依赖、动态收集输出文件来解决上述问题，修改后的NoTargets项目配置如下：

<Project Sdk="Microsoft.Build.NoTargets/3.7.0">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
    <PackageId>$(AssemblyName)</PackageId>
    <Title>My package</Title>
    <!-- 统一所有项目的输出目录到artifacts -->
    <BaseOutputPath>$(MSBuildProjectDirectory)/../artifacts/bin/</BaseOutputPath>
    <BaseIntermediateOutputPath>$(MSBuildProjectDirectory)/../artifacts/obj/</BaseIntermediateOutputPath>
  </PropertyGroup>

  <!-- 打包时包含tools目录下的脚本 -->
  <ItemGroup>
    <None Update="tools\*.ps1" Pack="True" PackagePath="tools\" />
  </ItemGroup>

  <!-- 定义需要构建的子项目 -->
  <ItemGroup>
    <ProjectToBuild Include="..\API\API.csproj" />
    <ProjectToBuild Include="..\Analyzers\Analyzers.csproj" />
    <!-- 如果StandardHelpers是单独项目，可以显式添加，或者依赖会自动触发构建 -->
    <!-- <ProjectToBuild Include="..\StandardHelpers\StandardHelpers.csproj" /> -->
  </ItemGroup>

  <!-- 构建所有子项目（包括依赖） -->
  <Target Name="BuildAllProjects" AfterTargets="Build">
    <MSBuild 
        Projects="@(ProjectToBuild)"
        Properties="Configuration=$(Configuration);
                   BaseOutputPath=$(BaseOutputPath);
                   BaseIntermediateOutputPath=$(BaseIntermediateOutputPath);
                   BuildProjectReferences=True" />
  </Target>

  <!-- 收集子项目输出并添加到打包项 -->
  <Target Name="CollectPackageFiles" AfterTargets="BuildAllProjects" BeforeTargets="GenerateNuspec">
    <!-- 收集API项目的输出到NuGet的lib目录 -->
    <ItemGroup>
      <PackageFile Include="$(BaseOutputPath)/$(Configuration)/API/net8.0/*.dll;$(BaseOutputPath)/$(Configuration)/API/net8.0/*.pdb">
        <PackagePath>lib/net8.0/</PackagePath>
      </PackageFile>
      <!-- 收集分析器项目的输出到analyzers目录 -->
      <PackageFile Include="$(BaseOutputPath)/$(Configuration)/Analyzers/net8.0/*.dll;$(BaseOutputPath)/$(Configuration)/Analyzers/net8.0/*.pdb;$(BaseOutputPath)/$(Configuration)/Analyzers/net8.0/*.ruleset">
        <PackagePath>analyzers/dotnet/cs/</PackagePath>
      </PackageFile>
    </ItemGroup>
  </Target>

  <!-- 设置NuSpec属性 -->
  <Target Name="SetNuSpecProperties" BeforeTargets="GenerateNuspec">
    <PropertyGroup>
      <NuspecProperties>$(NuspecProperties);Version=$(Version);PackageReleaseNotes=$(PackageReleaseNotes);Configuration=$(Configuration)</NuspecProperties>
    </PropertyGroup>
  </Target>

</Project>

关键修改说明 #

1. 统一输出目录：通过BaseOutputPath和BaseIntermediateOutputPath让所有项目（包括依赖的StandardHelpers）都输出到根目录的artifacts文件夹，确保依赖解析路径正确。
2. 自动构建依赖：MSBuild任务中添加BuildProjectReferences=True，会自动触发子项目的所有依赖项目构建，无需手动添加StandardHelpers到ProjectToBuild。
3. 动态收集输出：通过$(BaseOutputPath)/$(Configuration)/$(ProjectName)/$(TargetFramework)/路径动态获取子项目输出，避免硬编码路径。
4. 规范打包路径：将API程序集放到NuGet标准的lib/net8.0目录，分析器放到analyzers/dotnet/cs目录，符合NuGet包结构规范。

额外注意事项 #

• 如果子项目的TargetFramework与根项目不同，需要调整收集路径中的net8.0为对应框架版本，或者用$(TargetFramework)变量统一。
• 若需要包含XML文档注释，在PackageFile中添加*.xml后缀即可。

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