MAUI中如何动态或编译时合并资源字典并切换平台专属资源？

问题背景 #

我们定义了通用的资源字典：

<Application.Resources>
   <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
          <ResourceDictionary Source="Resources/Styles/Colors.xaml" />
          <ResourceDictionary Source="Resources/Styles/Styles.xaml" />
      </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Application.Resources>

如果要切换为Android专属资源，需要手动修改成：

<Application.Resources>
   <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
          <!-- There seem to be no way to choose based on platform.
          <ResourceDictionary Source="Resources/Styles/Colors.xaml" />
          <ResourceDictionary Source="Resources/Styles/Styles.xaml" />
          -->
          <ResourceDictionary Source="Resources/Styles/Android/Colors.xaml" />
          <ResourceDictionary Source="Resources/Styles/Android/Styles.xaml" />
      </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Application.Resources>

想知道有没有官方编译时方案能根据目标平台（比如编译到Android）自动完成这种切换？

目前尝试过的方案存在问题：

• 用MSBuild实现多目标切换时，要求必须指定完整路径，操作不便；
• OnPlatform目前不支持这种资源字典路径切换（未来可能支持）；
• 自行设想的方案是通过MSBuild正则读取App.xaml文件，处理前替换路径、处理后恢复以避免影响版本控制，但实现起来过于繁琐。

另外，这个需求和Fluent/Material设计资源的差异有关——两者定义差异大，需要避免打包冗余资源，只交付对应平台所需的资源。

最优官方方案 #

推荐使用MAUI的资源字典条件编译结合MSBuild的平台特定文件包含来实现，这是官方支持的编译时切换方案，无需手动修改App.xaml：

步骤1：按平台组织资源文件 #

将资源文件按平台分类存放：

• 通用资源：Resources/Styles/Colors.xaml、Resources/Styles/Styles.xaml
• Android专属资源：Resources/Styles/Android/Colors.xaml、Resources/Styles/Android/Styles.xaml
• iOS专属资源：Resources/Styles/iOS/Colors.xaml、Resources/Styles/iOS/Styles.xaml
• 其他平台同理

步骤2：修改项目文件（.csproj）配置 #

在项目文件中添加平台特定的资源字典引用，利用MSBuild的条件编译属性：

<!-- 通用资源默认引用 -->
<ItemGroup>
  <MauiXaml Include="Resources/Styles/Colors.xaml" />
  <MauiXaml Include="Resources/Styles/Styles.xaml" />
</ItemGroup>

<!-- Android平台替换为专属资源 -->
<ItemGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
  <MauiXaml Remove="Resources/Styles/Colors.xaml" />
  <MauiXaml Remove="Resources/Styles/Styles.xaml" />
  <MauiXaml Include="Resources/Styles/Android/Colors.xaml" LogicalName="Resources/Styles/Colors.xaml" />
  <MauiXaml Include="Resources/Styles/Android/Styles.xaml" LogicalName="Resources/Styles/Styles.xaml" />
</ItemGroup>

<!-- iOS平台替换为专属资源 -->
<ItemGroup Condition="'$(TargetFramework)' == 'net8.0-ios'">
  <MauiXaml Remove="Resources/Styles/Colors.xaml" />
  <MauiXaml Remove="Resources/Styles/Styles.xaml" />
  <MauiXaml Include="Resources/Styles/iOS/Colors.xaml" LogicalName="Resources/Styles/Colors.xaml" />
  <MauiXaml Include="Resources/Styles/iOS/Styles.xaml" LogicalName="Resources/Styles/Styles.xaml" />
</ItemGroup>

这里的LogicalName是核心——它让平台专属文件在编译时被视为通用路径的文件，这样App.xaml里的引用路径不需要做任何修改，编译时会自动替换为对应平台的文件。

步骤3：保持App.xaml不变 #

App.xaml依然使用通用路径引用，无需修改：

<Application.Resources>
   <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
          <ResourceDictionary Source="Resources/Styles/Colors.xaml" />
          <ResourceDictionary Source="Resources/Styles/Styles.xaml" />
      </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Application.Resources>

方案优势 #

• 完全基于官方MSBuild机制，稳定可靠；
• 无需修改App.xaml，避免手动操作出错；
• 编译时仅打包对应平台的资源，不会包含冗余文件；
• 版本控制不受影响，所有平台文件都能正常提交，编译时自动切换。

补充说明 #

如果需要更细粒度的控制（比如针对不同版本的平台），可以修改Condition属性，例如：

<ItemGroup Condition="'$(TargetFramework)' == 'net8.0-android34.0'">
  <!-- 针对Android 14的专属资源 -->
</ItemGroup>

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