升级WinUI3桌面项目至.NET8时遇RuntimeIdentifier未识别错误如何解决？

问题原因 #

.NET 8 调整了Windows平台Runtime Identifier的命名规则，废弃了win10-前缀，统一使用win-作为前缀。原配置中的win10-x86、win10-x64、win10-arm64标识符在.NET 8中不再被识别，因此触发NETSDK1083错误。

解决步骤 #

1. 更新RuntimeIdentifiers配置
   修改.csproj文件中的<RuntimeIdentifiers>节点，将原有带win10-前缀的标识符替换为win-开头的格式：

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

2. 同步更新发布配置文件名
   同时修改<PublishProfile>节点，将win10-$(Platform).pubxml改为win-$(Platform).pubxml，确保发布配置文件的命名与新标识符匹配：

   <PublishProfile>win-$(Platform).pubxml</PublishProfile>
   

修改后的完整PropertyGroup示例 #

<PropertyGroup>
  <OutputType>WinExe</OutputType>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
  <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
  <RootNamespace>SudokuEngineApp</RootNamespace>
  <ApplicationManifest>app.manifest</ApplicationManifest>
  <Platforms>x86;x64;ARM64</Platforms>
  <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
  <PublishProfile>win-$(Platform).pubxml</PublishProfile>
  <UseWinUI>true</UseWinUI>
  <EnableMsixTooling>true</EnableMsixTooling>
</PropertyGroup>

额外注意事项 #

如果之前手动创建过win10-开头的发布配置文件，需要同步将文件重命名为win-开头的格式，或者直接在Visual Studio中重新生成发布配置，避免出现发布时找不到配置文件的问题。

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