Xamarin Forms如何固定应用背景色 不受设备深色模式影响

你当前做的iOS和Android端配置逻辑正确，但存在配置位置、配套兜底缺失的问题，按以下步骤调整即可实现全设备背景色固定、完全不受系统深色模式/显示设置影响：

平台原生层配置（必做） #

iOS端 #

• 确认你在Info.plist中添加的UIUserInterfaceStyle配置位于根<dict>节点下，没有嵌套在其他键值对中。可直接打开Info.plist可视化编辑器，在iOS应用目标设置板块找到「User Interface Style」选项，选中Light即可避免手写XML的格式错误。
• 删除项目中所有监听TraitCollectionDidChange动态切换配色的自定义渲染逻辑，避免代码层覆盖配置。

Android端 #

• 你写的AppCompatDelegate.DefaultNightMode = AppCompatDelegate.ModeNightNo;必须放在MainActivity的OnCreate方法最开头，即base.OnCreate(savedInstanceState)调用之前执行，不要放在App生命周期或页面生命周期中，否则会出现启动瞬间闪深色模式的问题。
• 修改Resources/values/styles.xml中的主题配置，所有颜色值写死固定色值，禁止引用?android:attr/xxx这类随系统主题变化的动态属性，示例配置：

<style name="MainTheme" parent="MainTheme.Base">
  <item name="android:windowBackground">#FFFFFF</item> <!-- 替换为你需要的固定背景色 -->
  <item name="colorPrimary">#FFFFFF</item> <!-- 替换为你的固定主色 -->
  <item name="colorPrimaryDark">#F5F5F5</item> <!-- 替换为你的固定状态栏颜色 -->
  <item name="colorAccent">#2196F3</item> <!-- 替换为你的固定强调色 -->
</style>

UWP端（若项目适配UWP） #

• 打开UWP项目根目录下的App.xaml，给<Application>根节点添加RequestedTheme="Light"属性，强制UWP端固定浅色主题，示例：

<Application
    x:Class="YourAppName.UWP.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    RequestedTheme="Light">
</Application>

Xamarin.Forms 共享层兜底配置（必做） #

原生层配置只能屏蔽系统深色模式的默认行为，还需要在共享代码层固定所有页面和控件的颜色，避免动态配色逻辑覆盖：

• 打开共享项目的App.xaml，删除所有资源中使用AppThemeBinding的动态配色绑定，全部替换为固定色值。例如将随主题切换的颜色定义：

<Color x:Key="PageBackgroundColor">{AppThemeBinding Light=White, Dark=Black}</Color>

直接修改为固定色：

<Color x:Key="PageBackgroundColor">White</Color>

• 在全局资源字典中添加ContentPage的隐式样式，强制所有页面默认使用你指定的固定背景色，无需每个页面单独设置：

<Style TargetType="ContentPage" ApplyToDerivedTypes="True">
    <Setter Property="BackgroundColor" Value="White"/> <!-- 替换为你需要的固定背景色 -->
</Style>

• 检查项目中引用的第三方控件库，将所有默认跟随系统主题的控件手动设置为浅色模式、固定配色，不要保留FollowSystem类的主题配置。

验证注意事项 #

配置完成后先卸载测试设备上的旧版本安装包，再重新部署，避免旧应用缓存的主题配置影响测试结果。分别在iOS 13+、Android 10+以上版本的设备上切换系统深浅模式、调整系统显示对比度设置，确认应用全生命周期（启动、前后台切换、页面跳转）都不会出现颜色错乱、闪深色背景的问题。

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