WindowsAppSDK项目集成中的TargetPlatformVersion问题解析

问题背景

在使用WindowsAppSDK进行.NET 8项目开发时，开发者可能会遇到一个常见的配置问题：当在项目中添加WindowsAppSDK NuGet包后，项目无法加载并抛出"A numeric comparison was attempted on '$(TargetPlatformVersion)'"异常。这个问题的核心在于项目配置与WindowsAppSDK的兼容性要求不匹配。

问题现象

当创建一个新的.NET 8类库项目并添加WindowsAppSDK包后，系统会提示关于TargetPlatformVersion的警告，随后项目无法加载，并显示以下错误信息：

A numeric comparison was attempted on "$(TargetPlatformVersion)" that evaluates to "" instead of a number, in condition "'$(TargetPlatformVersion)' < '10.0.18362.0'"

问题根源分析

这个问题的根本原因在于WindowsAppSDK对目标平台版本有明确的最低要求（10.0.18362.0），但新建的.NET 8项目默认没有指定具体的Windows目标平台版本。当SDK尝试进行版本比较时，由于TargetPlatformVersion为空，导致比较操作失败。

解决方案

要解决这个问题，开发者需要明确指定项目的目标框架和Windows平台版本。以下是推荐的配置方式：

1. 完整指定目标框架： 在项目文件中使用完整的目标框架标识符，包括Windows平台版本：

<TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>

2. 处理运行时标识符问题： 如果遇到运行时包缺失的错误，可以添加以下配置：

<RuntimeIdentifiers>win-x64;win-x86</RuntimeIdentifiers>
<UseRidGraph>true</UseRidGraph>

3. 完整项目文件示例： 以下是一个可以正常工作的WPF项目配置示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
    <RuntimeIdentifiers>win-x64;win-x86</RuntimeIdentifiers>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UseWPF>true</UseWPF>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.5.240428000" />
  </ItemGroup>
</Project>

技术要点

1. 目标框架版本选择： WindowsAppSDK 1.5.x要求最低Windows 10版本为10.0.18362.0（2019年5月更新），建议使用较新的版本如10.0.22621.0（Windows 11 22H2）以获得更好的兼容性和功能支持。

2. 运行时标识符配置： 在.NET 8中，微软改变了运行时标识符的处理方式，需要显式指定支持的平台架构（win-x64/win-x86）并启用RID图功能。

3. 项目类型考虑： 对于WPF项目，必须确保<UseWPF>true</UseWPF>设置正确；对于WinUI3项目，则需要相应的项目模板和额外配置。

最佳实践建议

1. 创建新项目时，建议直接从WindowsAppSDK项目模板开始，而不是手动添加包引用。

2. 对于现有项目迁移，建议先备份项目文件，然后逐步添加必要的配置元素。

3. 保持开发环境更新，使用最新版本的Visual Studio和Windows SDK可以避免许多兼容性问题。

4. 在团队开发环境中，确保所有开发者的开发环境配置一致，特别是Windows SDK版本。

通过正确配置项目文件和理解WindowsAppSDK的版本要求，开发者可以避免这类配置问题，顺利地将WindowsAppSDK集成到.NET 8项目中。