Azure构建.NET MAUI项目时遇NETSDK1005错误求助

核心原因 #

Azure Pipelines默认环境未正确配置MAUI所需的Windows目标框架支持，或构建命令未指定正确目标，导致project.assets.json未生成对应net8.0的资产条目。

具体修复步骤 #

1. 安装MAUI工作负载 #

在Azure Pipelines的YAML中添加步骤，确保环境安装MAUI相关工作负载：

- task: CmdLine@2
  inputs:
    script: 'dotnet workload install maui-windows'

2. 显式指定构建目标框架 #

执行dotnet build时明确指定目标框架，避免环境自动选择偏差：

dotnet build Foo.csproj -f net8.0

若需构建Windows特定目标，可改为：

dotnet build Foo.csproj -f net8.0-windows10.0.19041.0

3. 清理并重新生成资产文件 #

构建前清理旧缓存并执行还原，确保资产文件正确生成：

- task: CmdLine@2
  inputs:
    script: 'dotnet clean Foo.csproj'
- task: CmdLine@2
  inputs:
    script: 'dotnet restore Foo.csproj'

4. 修正.csproj配置 #

确认项目文件中使用复数TargetFrameworks声明多目标，同时启用MAUI单项目属性：

<TargetFrameworks>net8.0;net8.0-windows10.0.19041.0</TargetFrameworks>
<UseMaui>true</UseMaui>
<SingleProject>true</SingleProject>

5. 消除MA002警告 #

MA002提示需启用SingleProject属性，确保上述.csproj配置中已添加该节点，让MAUI工具链正确识别项目结构。

完整Pipeline示例片段 #

steps:
- task: CmdLine@2
  inputs:
    script: 'dotnet workload install maui-windows'
- task: CmdLine@2
  inputs:
    script: 'dotnet clean Foo.csproj'
- task: CmdLine@2
  inputs:
    script: 'dotnet restore Foo.csproj'
- task: CmdLine@2
  inputs:
    script: 'dotnet build Foo.csproj -f net8.0 --configuration Release'

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