多项目仓库的DevOps NuGet构建流水线配置问询

问题背景 #

我管理一个包含多个项目的仓库，依赖结构如下：

• ProjectA
  • 依赖项：ProjectB
• ProjectB
  • 依赖项：无
• ProjectC
  • 依赖项：ProjectB
• ProjectD
  • 依赖项：ProjectA、ProjectB、ProjectC

需求是：当拉取请求（PR）合并到master分支时，触发DevOps流水线，为所有项目生成工件，且所有工件都引用新版本的依赖。比如当前版本都是1.0.0，合并后ProjectD的工件要引用1.0.1版本的ProjectA、ProjectB、ProjectC。

开发阶段用ProjectReference实现项目间引用，但生成工件时需要切换为PackageReference。尝试过在.csproj里用Release/Debug条件分别配置两种引用，但解决不了构建时引用尚未生成的新版本的问题。

解决方案 #

1. 统一版本管理 #

在仓库根目录创建Directory.Build.props文件，统一管理所有项目的版本号，流水线触发时自动生成递增版本（比如基于Git提交记录或流水线ID）。示例配置：

<Project>
  <PropertyGroup>
    <Version>$(BuildVersion)</Version>
    <PackageVersion>$(BuildVersion)</PackageVersion>
  </PropertyGroup>
</Project>

流水线中定义BuildVersion变量（例如1.0.$(BuildId)），所有项目会自动继承这个版本号。

2. 动态切换引用类型 #

在每个项目的.csproj文件中，通过自定义条件变量区分开发与构建场景：

• 开发环境使用ProjectReference
• 构建工件时使用PackageReference，并直接引用统一版本号

示例.csproj配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>

  <!-- 开发模式：使用ProjectReference -->
  <ItemGroup Condition="'$(BuildForPackage)' != 'true'">
    <ProjectReference Include="..\ProjectB\ProjectB.csproj" />
  </ItemGroup>

  <!-- 构建工件模式：使用PackageReference，引用统一版本 -->
  <ItemGroup Condition="'$(BuildForPackage)' == 'true'">
    <PackageReference Include="ProjectB" Version="$(BuildVersion)" />
  </ItemGroup>
</Project>

3. 流水线分阶段执行 #

流水线需按以下步骤执行，解决依赖时序问题：

1. 生成版本号：根据流水线ID或Git标签生成新版本号，赋值给BuildVersion变量。
2. 打包并上传工件：设置BuildForPackage=true，按依赖顺序打包项目（先ProjectB，再ProjectA、ProjectC，最后ProjectD），打包完成后立即上传到私有工件库（如DevOps内置的NuGet源）。
3. 验证依赖正确性：可选步骤，拉取刚上传的包进行验证，确保所有依赖版本匹配当前流水线生成的版本。

示例Azure DevOps流水线步骤：

steps:
- task: NuGetAuthenticate@1
  displayName: 'NuGet身份验证'

- script: dotnet pack --configuration Release /p:BuildForPackage=true /p:BuildVersion=$(BuildVersion) --output $(Build.ArtifactStagingDirectory)
  displayName: '打包所有项目'

- task: NuGetCommand@2
  displayName: '推送包到工件源'
  inputs:
    command: push
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg'
    nuGetFeedType: internal
    publishVstsFeed: '你的工件源名称'

4. 关键注意事项 #

• 统一版本号确保同一次流水线中所有项目生成的版本一致，避免依赖版本混乱。
• BuildForPackage是自定义条件变量，开发时无需设置，仅在流水线构建时传入。
• 先打包上传所有依赖项目，后续项目打包时就能直接从私有工件源拉取刚生成的新版本包，解决“引用未生成版本”的问题。

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