Azure Pipelines Nuget 还原失败 MSB4226

Question

我正在尝试为项目设置 Azure 管道，但我的 yml 中的 nuget restore 命令失败。以下是完整的错误：

[错误] nuget 命令失败，退出代码(1) 和错误(D:\a\1\s\UDesign\Backup\UDesign\UDesign.csproj(190,11): 错误 MSB4226: 导入的项目"找不到 C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Microsoft\VisualStudio\v10.0\WebApplications\Microsoft.WebApplication.targets。另外，试图找到“Microsoft\VisualStudio\v10 .0\WebApplications\Microsoft.WebApplication.targets" 在 $(MSBuildExtensionsPath32) 的后备搜索路径中 - "C:\Program Files (x86)\MSBuild" 。这些搜索路径在 "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Current\Bin\msbuild.exe.Config"。确认声明中的路径是正确的，并且该文件存在于磁盘上的任一搜索路径中。） ##[error]包恢复失败

几乎所有关于此错误的帖子都在 YML 中的 Build 命令上，但在 Nuget Restore 上却失败了：

Pipelines failure image

YML 下面：

# .NET Desktop
# Build and run tests for .NET Desktop or Windows classic desktop solutions.
# Add steps that publish symbols, save build artifacts, and more:
# https://docs.microsoft.com/azure/devops/pipelines/apps/windows/dot-net

trigger:
- master

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '$(solution)'
    feedsToUse: 'select'
    vstsFeed: 'MyFeed'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:OutputPath="$(Build.BinariesDirectory)\$(Build.BuildID)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'
    restoreNugetPackages: true
    msbuildArchitecture: 'x64'

- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)\$(Build.BuildId)'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true

- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'
    publishLocation: 'Container'

我不确定问题出在配置上还是我的 NuGet 包上，我在这个问题上找不到太多信息。

Answer 1

实际问题

这个问题实际上与 NuGet 无关，只是 NuGet 是管道中尝试评估 MSBuild 文件的第一件事。如果你仔细看错误：

错误 MSB4226：找不到导入的项目“C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Microsoft\VisualStudio\v10.0\WebApplications\Microsoft.WebApplication.targets”。

可以看到报错是MSBuild找不到Microsoft.WebApplication.targets。这是什么意思？我不是 100% 有信心，但我非常有信心，这意味着您使用的是“自托管”CI 代理，而不是 a Microsoft hosted agent，并且任何设置机器的人都安装了 Visual Studio 2019 而没有安装 ASP.NET工作量。因此，任何设置 CI 代理的人都应该安装“ASP.NET 和 Web 开发”工作负载。

建议 1：CI 代理应使用 BuildTools SKU

如果您查看VS's release and build history，您会看到每个版本的“安装程序链接”下都有一个“BuildTools”链接。这是 Visual Studio 的一个子集，没有所有的 GUI 东西，专门用于 CI 代理。我认为 BuildTools SKU 没有工作负载选项，它只是安装所有工作负载所需的所有构建工具。

只有在极少数情况下，CI 代理才需要“完整”的 Visual Studio，因此除非您知道自己处于这种情况，否则我建议您在 CI 代理上安装 BuildTools，而不是在 Enterprise 或 Professional 上安装。

建议2：不要使用NuGetCommand

有两个原因。首先，NuGetCommand 是一个使用 NuGet.exe 的任务。 NuGet.exe 的问题在于，当您使用PackageReference 而不是packages.config 时，有时NuGet 和构建工具（msbuild 的道具/目标）会更改临时文件的文件格式。如果您没有使 NuGet.exe 的版本与 MSBuild/Visual Studio 的版本保持一致，则可能会出现构建错误。所以，最好使用dotnet restore，或者如果你不能使用dotnet cli，那么使用msbuild -t:restore。这样，您始终可以使用专为安装的 dotnet/msbuild 版本设计的 NuGet 的确切版本，并且您再也不必考虑 NuGet-MSBuild 版本问题。

其次，someone from the Azure DevOps team told my team that they want to deprecate these "heavy" tasks, and suggest customers call commands directly in a script task。特别是，他们实现这些功能的方式将破坏 NuGet 的新包源映射功能。

如果你的解决方案只包含 SDK 风格的项目，那么我建议你使用：

- task: NuGetAuthenticate
  displayName: Set up NuGet authentication
- script: dotnet restore $(solution)
  displayName: Restore

如果您的解决方案包含任何“遗留”（非 SDK 样式）项目，则不要使用 dotnet CLI，而是使用 - script: msbuild -t:restore $(solution)。

建议 3：不要使用 VSBuild

您正在使用任务VSBuild 来运行您的构建。这是一个使用devenv.com 构建项目的任务。虽然 devenv 确实具有从命令行构建的命令行参数，但 msbuild.exe 是进行命令行构建的“官方”工具。同样，除非您知道自己处于真正需要通过devenv /build 构建的特殊情况，否则我建议您改用dotnet CLI 或MSBuild。如前所述，Azure DevOps 团队显然希望弃用“繁重”任务，因此我建议您使用脚本并直接调用dotnet 或msbuild。

- script: msbuild -t:build $(solution)
  displayName: Build solution

Answer 2

你可以试试这个

注意：你需要根据你的项目替换源路径和目标路径。

variables:
- name: BuildParameters.RestoreBuildProjects
  value: '**/*.csproj'
- name: BuildParameters.TestProjects
  value: '**/*[Tt]ests/*.csproj'
trigger:
  branches:
    include:
    - refs/heads/master
name: $(date:yyyyMMdd)$(rev:.r)
jobs:
- job: Job_1
  displayName: Agent job 1
  pool:
    vmImage: windows-2019
  steps:
  - checkout: self
  - task: DotNetCoreCLI@2
    displayName: Restore
    inputs:
      command: restore
      projects: $(BuildParameters.RestoreBuildProjects)
  - task: DotNetCoreCLI@2
    displayName: Build
    inputs:
      projects: $(BuildParameters.RestoreBuildProjects)
      arguments: --configuration $(BuildConfiguration)
  - task: DotNetCoreCLI@2
    displayName: Test
    enabled: False
    inputs:
      command: test
      projects: $(BuildParameters.TestProjects)
      arguments: --configuration $(BuildConfiguration)
  - task: DotNetCoreCLI@2
    displayName: Publish
    inputs:
      command: publish
      publishWebProjects: True
      projects: $(BuildParameters.RestoreBuildProjects)
      arguments: --configuration $(BuildConfiguration) --output $(build.artifactstagingdirectory)
      zipAfterPublish: True
  - task: PublishBuildArtifacts@1
    displayName: Publish Artifact
    condition: succeededOrFailed()
    inputs:
      PathtoPublish: $(build.artifactstagingdirectory)
      TargetPath: '\\my\share\$(Build.DefinitionName)\$(Build.BuildNumber)'
...