Azure DevOps构建.NET8 MAUI类库NuGet包失败，求修改方案

一、修复“Workload ID maui isn't supported on this platform.”错误 #

这个错误的核心是流水线代理机器未安装MAUI工作负载，或使用了不支持MAUI的操作系统，按以下步骤修改：

1. 指定支持MAUI的代理池
   必须使用Windows系统的代理，Azure DevOps的windows-latest镜像预装了.NET SDK，是最稳妥的选择，避免使用Linux或macOS代理（需额外复杂配置）。

2. 添加MAUI工作负载安装步骤
   在构建前执行dotnet workload install maui命令，确保MAUI环境就绪，同时指定.NET8 SDK版本避免版本不匹配。

修改后的流水线片段示例：

pool:
  vmImage: 'windows-latest'

steps:
- task: UseDotNet@2
  inputs:
    packageType: 'sdk'
    version: '8.x'
    includePreviewVersions: false

- script: dotnet workload install maui --source https://api.nuget.org/v3/index.json
  displayName: '安装.NET MAUI工作负载'

- script: dotnet restore YourMauiLibrary.csproj
  displayName: '还原依赖'

- script: dotnet build YourMauiLibrary.csproj --configuration Release
  displayName: '构建MAUI类库'

二、修复NuGet包上传后不被识别的问题 #

包不被识别通常是元数据缺失、包结构损坏或上传流程错误导致的，按以下处理：

1. 补全项目文件中的NuGet元数据
   在MAUI类库的.csproj文件中添加必填的包信息，NuGet官网要求这些字段完整才会正常识别：

<PropertyGroup>
  <PackageId>你的唯一包ID（不可与现有包重复）</PackageId>
  <Version>1.0.0</Version>
  <Authors>你的名字/团队名</Authors>
  <Description>MAUI类库的功能描述</Description>
  <PackageLicenseExpression>MIT</PackageLicenseExpression> <!-- 选择合适的开源协议 -->
  <RepositoryUrl>你的Azure DevOps仓库地址</RepositoryUrl>
</PropertyGroup>

2. 用规范命令打包
   打包时使用dotnet pack命令，确保输出到流水线的工件目录，不要手动修改生成的.nupkg文件：

- script: dotnet pack YourMauiLibrary.csproj --configuration Release --output $(Build.ArtifactStagingDirectory)
  displayName: '生成NuGet包'

3. 使用官方任务上传
   不要手动上传包，用Azure DevOps的NuGetCommand@2任务完成上传，确保流程合规：

- task: NuGetCommand@2
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg'
    nuGetFeedType: 'external'
    publishFeedCredentials: '你的NuGet服务连接' # 提前在Azure DevOps配置好NuGet服务连接

4. 本地验证包完整性
   本地生成包后，用nuget verify YourPackageName.nupkg命令检查包是否符合规范，排除损坏问题后再上传。

完整流水线示例 #

trigger:
- main

pool:
  vmImage: 'windows-latest'

steps:
- task: UseDotNet@2
  inputs:
    packageType: 'sdk'
    version: '8.x'
    includePreviewVersions: false

- script: dotnet workload install maui --source https://api.nuget.org/v3/index.json
  displayName: '安装.NET MAUI工作负载'

- script: dotnet restore YourMauiLibrary.csproj
  displayName: '还原依赖'

- script: dotnet build YourMauiLibrary.csproj --configuration Release
  displayName: '构建MAUI类库'

- script: dotnet pack YourMauiLibrary.csproj --configuration Release --output $(Build.ArtifactStagingDirectory)
  displayName: '生成NuGet包'

- task: NuGetCommand@2
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg'
    nuGetFeedType: 'external'
    publishFeedCredentials: '你的NuGet服务连接'

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