能否创建兼容WinUI3/WinUI2及WPF的多目标资源字典类库？

可行性结论 #

完全可以创建同时兼容WinUI 3、WinUI 2及WPF的多目标类库，并包含ResourceDictionary资源。核心思路是通过条件化项目配置和分框架资源文件组织来处理不同平台的差异。

具体实现步骤 #

1. 配置多目标框架

在项目的.csproj文件中明确指定需要兼容的目标框架，示例如下：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net6.0-windows10.0.19041.0;uap10.0.17763;net6.0-windows</TargetFrameworks>
    <UseWPF Condition="'$(TargetFramework)' == 'net6.0-windows'">true</UseWPF>
    <UseWinUI Condition="'$(TargetFramework)' != 'net6.0-windows'">true</UseWinUI>
    <OutputType>Library</OutputType>
  </PropertyGroup>

  <!-- 条件引入NuGet依赖 -->
  <ItemGroup Condition="'$(TargetFramework)' == 'net6.0-windows10.0.19041.0'">
    <PackageReference Include="Microsoft.UI.Xaml" Version="2.8.4" />
  </ItemGroup>
  <ItemGroup Condition="'$(TargetFramework)' == 'uap10.0.17763'">
    <PackageReference Include="Microsoft.UI.Xaml.Uwp" Version="2.8.4" />
  </ItemGroup>
</Project>

• net6.0-windows10.0.19041.0：对应WinUI 3（Windows App SDK）
• uap10.0.17763：对应WinUI 2（UWP平台）
• net6.0-windows：对应WPF

2. 组织ResourceDictionary资源

由于不同框架的XAML控件属性、样式语法存在差异，建议按框架拆分资源文件：

• 在项目中创建三个文件夹：WinUI3Resources、WinUI2Resources、WPFResources
• 分别在每个文件夹下放置对应框架的ResourceDictionary文件（如Styles.xaml、Colors.xaml）
• 在.csproj中通过条件配置仅包含当前目标框架的资源文件：

<ItemGroup Condition="'$(TargetFramework)' == 'net6.0-windows10.0.19041.0'">
  <Page Include="WinUI3Resources\**\*.xaml" />
</ItemGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'uap10.0.17763'">
  <Page Include="WinUI2Resources\**\*.xaml" />
</ItemGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'net6.0-windows'">
  <Page Include="WPFResources\**\*.xaml" />
</ItemGroup>

3. 统一资源调用体验

• 尽量保持不同框架下的资源键名一致（如PrimaryButtonStyle），这样调用端无需额外适配
• 如果有代码逻辑需要跨框架，可使用编译常量区分：

#if NET6_0_WINDOWS10_0_19041_0
// WinUI 3 专属逻辑
#elif UAP10_0_17763
// WinUI 2 专属逻辑
#elif NET6_0_WINDOWS
// WPF 专属逻辑
#endif

WPF兼容注意事项 #

WPF与WinUI的ResourceDictionary语法大体相似，但部分控件（如Button、TextBox）的样式结构、依赖属性存在差异，因此需要单独维护WPF版本的资源文件。多目标类库对WPF的支持与WinUI一致，通过条件配置即可实现。

常见问题解决 #

你之前遇到的「项目配置差异大」问题，核心是要为不同目标框架单独配置属性和依赖。例如WinUI 3需要启用UseWinUI，而WPF需要启用UseWPF；依赖包也需按框架区分引入，避免版本冲突。

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