.NET Maui中Android端DatePicker设为Spinner模式无效问题排查

问题根源 #

你当前的配置存在两个核心问题：

1. 主题属性选择错误：使用了通用的android:dialogTheme来配置对话框样式，但Maui的DatePicker弹窗需要通过android:datePickerDialogTheme这个专属属性来覆盖，通用对话框主题不会作用于DatePicker的弹窗。
2. 样式兼容性不足：针对Android 11及以上版本，Widget.Material.Light.DatePicker的部分属性可能不被系统优先识别，导致Spinner模式配置失效。

修复方案一：调整样式文件配置 #

修改Platforms/Android/Resources/values/styles.xml，替换为以下代码：

<?xml version="1.0" encoding="utf-8" ?>
<resources>
  <style name="Maui.SplashTheme" parent="MainTheme.Base">
      <!-- 替换为DatePicker弹窗专属主题属性 -->
      <item name="android:datePickerDialogTheme">@style/CustomDatePickerDialogTheme</item>
  </style>

  <!-- 自定义DatePicker弹窗主题 -->
  <style name="CustomDatePickerDialogTheme" parent="Theme.MaterialComponents.Light.Dialog">
      <item name="colorAccent">#FF4081</item>
      <item name="android:datePickerStyle">@style/CustomDatePickerStyle</item>
  </style>

  <!-- 适配多版本的Spinner模式样式 -->
  <style name="CustomDatePickerStyle" parent="android:Widget.Material.Light.DatePicker">
      <item name="android:datePickerMode">spinner</item>
      <item name="android:calendarViewShown">false</item>
      <item name="android:spinnersShown">true</item>
  </style>

  <!-- 针对Android 11+的兼容性配置 -->
  <style name="CustomDatePickerStyle" parent="android:Widget.Material.DatePicker" tools:targetApi="r">
      <item name="android:datePickerMode">spinner</item>
      <item name="android:calendarViewShown">false</item>
      <item name="android:spinnersShown">true</item>
  </style>
</resources>

修复方案二：自定义Handler强制设置Spinner模式（更可靠） #

如果样式配置仍不生效，可以通过自定义DatePickerHandler直接控制Android原生控件：

1. 在Platforms/Android/Handlers目录下创建CustomDatePickerHandler.cs：

using Android.Widget;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.Android.Handlers;

public class CustomDatePickerHandler : DatePickerHandler
{
    protected override void ConnectHandler(DatePickerPlatformView platformView)
    {
        base.ConnectHandler(platformView);
        
        if (platformView.Context.GetTheme().ResolveAttribute(Android.Resource.Attribute.DatePickerDialogTheme, out var attr))
        {
            var dialogTheme = platformView.Context.Resources.GetResourceId(attr, 0);
            var datePickerDialog = new DatePickerDialog(
                platformView.Context, 
                dialogTheme, 
                (s, e) => VirtualView.Date = e.Date,
                VirtualView.Date.Year, 
                VirtualView.Date.Month - 1, 
                VirtualView.Date.Day);
            
            // 强制启用Spinner模式
            var datePicker = datePickerDialog.DatePicker;
            datePicker.CalendarViewShown = false;
            datePicker.SpinnersShown = true;
            
            // 替换默认弹窗逻辑
            platformView.Click -= PlatformView_Click;
            platformView.Click += (s, e) => datePickerDialog.Show();
        }
    }
}

2. 在MauiProgram.cs中注册自定义Handler：

using YourAppNamespace.Platforms.Android.Handlers;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
            });

#if ANDROID
        builder.ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler<DatePicker, CustomDatePickerHandler>();
        });
#endif

        return builder.Build();
    }
}

最后步骤 #

修改完成后，删除项目的bin和obj文件夹，清理Android资源缓存，然后重新构建并运行项目。

内容的提问来源于stack exchange，提问作者today and i.