.NET MAUI Windows发布构建问题：RID不匹配（VS/Rider）

问题背景 #

开发.NET MAUI应用时，通过Visual Studio 2022或JetBrains Rider 2023.3的GUI发布侧加载安装程序时，遇到Runtime Identifier（RID）不匹配问题：既提示win10-x86无法识别，又不支持win-x64/win-x86/win-arm64等.NET 8标准RID，但通过CLI指定对应RID能正常完成发布。

解决方案 #

1. 同步MAUI项目与MSIX打包项目的RID配置 #

打开MAUI项目的.csproj文件，确保已添加.NET 8标准RID集合：

<PropertyGroup>
  <RuntimeIdentifiers>win-x64;win-x86;win-arm64</RuntimeIdentifiers>
</PropertyGroup>

同时打开MSIX打包项目的.wapproj文件，同步设置匹配的RID：

<PropertyGroup>
  <RuntimeIdentifier>win-x64</RuntimeIdentifier> <!-- 按需选择对应RID即可 -->
</PropertyGroup>

两者RID必须完全一致，避免IDE发布时出现配置冲突。

2. 手动指定IDE发布向导的目标运行时 #

• Visual Studio：
  进入发布向导的「配置」页面，找到「目标运行时」选项。如果下拉列表未显示.NET 8标准RID，点击「编辑」按钮，手动输入win-x64等标准RID并保存配置。
• Rider：
  在发布配置窗口中，找到「Runtime Identifier」选项，直接选择或手动输入.NET 8标准RID，保存后重新尝试发布。

3. 清理IDE与项目缓存 #

• Visual Studio：
  删除项目目录下的bin、obj文件夹，执行「生成 -> 清理解决方案」「生成 -> 重建解决方案」；同时删除%LOCALAPPDATA%\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache目录下的缓存文件，重启VS后重试。
• Rider：
  点击菜单栏「File -> Invalidate Caches...」，选择「Invalidate and Restart」，清除IDE缓存后重新发布。

4. 强制IDE使用指定.NET 8 SDK #

在项目根目录创建global.json文件，锁定.NET 8 SDK版本，避免IDE混用旧版本导致RID识别异常：

{
  "sdk": {
    "version": "8.0.100", // 替换为你安装的最新.NET 8 SDK版本
    "rollForward": "latestMinor"
  }
}

5. 验证MAUI工作负载完整性 #

执行以下命令检查并更新MAUI工作负载：

dotnet workload list
dotnet workload install maui --force

确保microsoft.net.sdk.maui工作负载为.NET 8版本，避免旧版本工作负载引发的RID识别问题。

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