.NET MAUI Android示例应用点击按钮后文本无法更新问题

问题现象 #

将VS2022更新至17.3.0 Preview 2版本后，参照官方教程创建的.NET MAUI应用存在跨平台表现不一致问题：

• Windows端运行正常：触发OnCounterClicked方法时按钮文本可正常更新，运行效果如下：
  
• 按钮点击事件实现代码如下：

private void OnCounterClicked(object sender, EventArgs e)
{
    count++;
    if (count == 1)
        CounterBtn.Text = $"Clicked {count} time";
    else
        CounterBtn.Text = $"Clicked {count} times";
    
    SemanticScreenReader.Announce(CounterBtn.Text);
}

• Android模拟器端运行异常：点击按钮后文本无更新。已确认OnCounterClicked方法可正常执行，CounterBtn.Text能被赋值为正确值，设备日志无错误信息、IDE无异常抛出，Android端运行效果如下：
  
  触发SemanticScreenReader.Announce方法时的调用栈截图如下：
  

问题根因 #

这是VS2022 17.3.0 Preview 2捆绑的.NET MAUI预览版本的已知Android平台渲染缺陷：

1. 该预览版本中Android平台Button控件的Handler存在属性更新通知失效问题，代码后置修改Button.Text属性时，属性变更事件没有正确传递到原生Android按钮控件，原生视图不会触发重绘，即使托管层属性值已经正确修改，UI也不会同步刷新。
2. 该版本下SemanticScreenReader.Announce在Android端会抢占UI线程的无障碍服务通道，进一步阻塞控件属性更新调度，放大了渲染异常问题。

修复方案 #

按优先级选择以下任意一种方案即可解决：

• 推荐方案：直接将VS2022升级到17.3正式版或更高版本，微软在正式发布版本中已经修复了Button Handler的属性同步bug，升级后无需修改任何业务代码即可正常运行。
• 临时适配预览版本的方案：
  • 方案1：给按钮属性赋值后手动强制触发控件重绘，在SemanticScreenReader.Announce调用前添加一行CounterBtn.InvalidateMeasure()，强制控件重新测量、渲染，绕开属性通知失效的问题。
  • 方案2：如果不需要无障碍读屏能力，可以暂时注释SemanticScreenReader.Announce(CounterBtn.Text);代码行，避免无障碍服务阻塞UI更新调度。
  • 方案3：在MauiProgram.cs中为Button控件添加临时属性映射修复，手动将MAUI层的Text属性同步到原生控件，绕过默认存在缺陷的属性映射逻辑，代码如下：

    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        })
        // 新增以下临时修复代码
        .ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler<Button, ButtonHandler>(h =>
            {
                h.AppendMapping(nameof(IButton.Text), (handler, view) =>
                {
                    if (handler.PlatformView != null)
                        handler.PlatformView.Text = view.Text;
                });
            });
        });
    

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