MAUI.NET中如何正确强制切换Android原生日夜主题并解决重建报错

问题根源 #

• 仅切换MAUI的UserAppTheme无法完全同步Android原生日夜主题，导致部分控件（如按钮点击反馈、Picker背景）样式异常，需重建Activity使Android主题设置生效。
• 在设置页调用Platform.CurrentActivity.Recreate()时，因当前页面处于导航栈/模态状态，Activity可能已进入销毁流程或未完全就绪，触发Java.Lang.IllegalArgumentException。

可行解决方案 #

1. 延迟执行Activity重建，确保Activity处于活跃状态 #

通过Android原生Handler延迟执行重建操作，避开设置页的生命周期冲突：

internal static void ChangeAppTheme(int selectedThemeIndex)
{ 
  switch (selectedThemeIndex) 
  { 
    case 0: App.Current.UserAppTheme = AppTheme.Unspecified; break; 
    case 1: App.Current.UserAppTheme = AppTheme.Dark; break; 
    case 2: App.Current.UserAppTheme = AppTheme.Light; break; 
  }
#if ANDROID
  AndroidX.AppCompat.App.AppCompatDelegate.DefaultNightMode = App.Current.UserAppTheme switch 
  { 
    AppTheme.Light => AndroidX.AppCompat.App.AppCompatDelegate.ModeNightNo, 
    AppTheme.Dark => AndroidX.AppCompat.App.AppCompatDelegate.ModeNightYes, 
    _ => AndroidX.AppCompat.App.AppCompatDelegate.ModeNightFollowSystem 
  };

  var currentActivity = Platform.CurrentActivity;
  if (currentActivity != null && !currentActivity.IsDestroyed)
  {
      currentActivity.RunOnUiThread(() =>
      {
          new Android.OS.Handler(Android.OS.Looper.MainLooper).PostDelayed(() =>
          {
              currentActivity.Recreate();
          }, 100); // 延迟100ms确保设置页操作完成
      });
  }
#endif
} 

2. 关闭设置页后再执行Activity重建 #

如果设置页是通过模态弹窗或导航栈打开的，先关闭页面再触发重建，避免Activity状态冲突：

// 设置页内的主题切换事件处理
private async void OnThemeOptionSelected(int selectedIndex)
{
    // 先切换主题
    ThemeHelper.ChangeAppTheme(selectedIndex);
    // 关闭设置页
    await Navigation.PopModalAsync(); // 若为导航栈则用PopAsync()
    
#if ANDROID
    var currentActivity = Platform.CurrentActivity;
    if (currentActivity != null && !currentActivity.IsDestroyed)
    {
        currentActivity.Recreate();
    }
#endif
}

3. 优化MAUI样式适配，减少对Android原生主题的依赖 #

通过MAUI的AppThemeBinding定义控件在明暗模式下的样式，无需依赖Android原生主题即可实现正确视觉反馈：

<!-- Resources/Styles/Styles.xaml -->
<Style TargetType="Button">
    <Setter Property="VisualStateManager.VisualStateGroups">
        <VisualStateGroupList>
            <VisualStateGroup x:Name="CommonStates">
                <VisualState x:Name="Normal"/>
                <VisualState x:Name="Pressed">
                    <VisualState.Setters>
                        <Setter Property="BackgroundColor" 
                                Value="{AppThemeBinding Light={StaticResource LightButtonPressed}, Dark={StaticResource DarkButtonPressed}}"/>
                    </VisualState.Setters>
                </VisualState>
            </VisualStateGroup>
        </VisualStateGroupList>
    </Setter>
</Style>

提前在Resources/Styles/Colors.xaml中定义对应颜色资源：

<Color x:Key="LightButtonPressed">#E0E0E0</Color>
<Color x:Key="DarkButtonPressed">#424242</Color>

总结 #

优先通过MAUI自身样式系统适配明暗主题，减少对Android原生主题的依赖；若必须重建Activity，需确保操作时机在Activity活跃状态下，或等待子页面关闭后执行。

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