如何配置Azure Pipeline生成包含所有依赖的.NET Core 3.1类库单NuGet包并存储至Azure Feed

咱们先把需求拆解清楚：你有10个.NET Core 3.1类库，主项目引用了其他9个，要打包成单个包含所有依赖DLL的NuGet包，再推到Azure Artifacts Feed。下面分两步走：先搞定NuGet的打包配置，再写Azure Pipeline的YAML。

第一步：准备NuGet规格文件（.nuspec） #

默认的dotnet pack只会打包单个项目的输出，咱们需要手动定义.nuspec文件来把所有依赖类库的DLL都包含进来。

1. 在你的主类库项目根目录，打开终端运行：

   dotnet new nuspec
   

2. 编辑生成的.nuspec文件，重点配置<metadata>和<files>节点：

   <?xml version="1.0" encoding="utf-8"?>
   <package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
     <metadata>
       <id>Your.Core.Solution.Package</id> <!-- NuGet包的唯一ID，自定义命名 -->
       <version>$version$</version> <!-- 版本号将由Pipeline传入 -->
       <authors>你的团队/个人名称</authors>
       <description>整合CORE解决方案所有类库功能的NuGet包</description>
       <dependencies>
         <!-- 如果类库依赖第三方NuGet包，这里要手动添加，示例：
         <group targetFramework=".NETCoreApp3.1">
           <dependency id="Newtonsoft.Json" version="13.0.3" />
         </group>
         -->
       </dependencies>
       <targetFramework>netcoreapp3.1</targetFramework>
     </metadata>
     <files>
       <!-- 主项目的输出DLL和调试文件 -->
       <file src="bin/Release/netcoreapp3.1/Your.Main.Project.dll" target="lib/netcoreapp3.1" />
       <file src="bin/Release/netcoreapp3.1/Your.Main.Project.pdb" target="lib/netcoreapp3.1" />
       <!-- 其他依赖类库的输出文件，逐个添加 -->
       <file src="..\Your.Lib.Project1\bin\Release/netcoreapp3.1/Your.Lib.Project1.dll" target="lib/netcoreapp3.1" />
       <file src="..\Your.Lib.Project1\bin\Release/netcoreapp3.1/Your.Lib.Project1.pdb" target="lib/netcoreapp3.1" />
       <file src="..\Your.Lib.Project2\bin\Release/netcoreapp3.1/Your.Lib.Project2.dll" target="lib/netcoreapp3.1" />
       <!-- 剩下的7个类库依此类推，注意路径要匹配你的解决方案目录结构 -->
     </files>
   </package>
   

第二步：配置Azure Pipeline YAML #

在解决方案根目录创建azure-pipelines.yml，包含以下核心阶段：

1. 基础触发与变量配置 #

trigger:
  branches:
    include:
      - main # 触发构建的分支，根据你的实际分支名修改
pr: none # 不需要PR触发构建的话可保留，反之删除

variables:
  buildConfiguration: 'Release'
  nugetPackageVersion: '$(Build.BuildNumber)' # 用Pipeline构建号作为NuGet版本，也可自定义规则
  azureFeedName: '你的AzureFeed名称' # 替换成你的Azure Artifacts Feed名
  azureFeedProject: '你的AzureDevOps项目名' # 替换成你的项目名称

2. 安装.NET Core 3.1 SDK #

steps:
- task: UseDotNet@2
  displayName: '安装.NET Core 3.1 SDK'
  inputs:
    packageType: 'sdk'
    version: '3.1.x'

3. 构建整个解决方案 #

确保所有类库都编译为Release版本：

- task: DotNetCoreCLI@2
  displayName: '构建解决方案'
  inputs:
    command: 'build'
    projects: '**/*.sln'
    arguments: '--configuration $(buildConfiguration)'

4. 打包NuGet包 #

用咱们定义的.nuspec文件生成整合包：

- task: DotNetCoreCLI@2
  displayName: '打包NuGet包'
  inputs:
    command: 'pack'
    packagesToPack: '**/Your.Main.Project/Your.Main.Project.nuspec' # 指向主项目的nuspec文件路径
    versioningScheme: 'byEnvVar'
    versionEnvVar: 'nugetPackageVersion'
    arguments: '--configuration $(buildConfiguration)'

5. 发布到Azure Artifacts Feed #

先完成身份验证，再推送包：

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

- task: DotNetCoreCLI@2
  displayName: '推送NuGet包到Azure Feed'
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg'
    nuGetFeedType: 'internal'
    publishVstsFeed: '$(azureFeedProject)/$(azureFeedName)'

关键注意事项 #

• 版本号灵活调整：如果需要更精细化的版本规则，可以用GitVersion工具替换$(Build.BuildNumber)，实现基于Git提交记录的自动版本生成。
• 第三方依赖同步：如果你的类库依赖外部NuGet包，必须在.nuspec的<dependencies>节点中明确声明，否则使用此包的项目会缺失依赖。
• 权限配置：确保Azure Pipeline的构建服务账号拥有Azure Artifacts Feed的推送权限，否则会出现推送失败的权限错误。
• 路径验证：首次运行Pipeline前，建议手动编译解决方案，确认所有类库的Release输出路径和.nuspec中的src路径完全匹配。

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