迁移Xamarin至MAUI时自定义SearchBar渲染器触发Android.Views.InflateException

问题根源 #

.NET MAUI已废弃Xamarin的SearchBarRenderer组件，直接沿用旧自定义渲染器的布局逻辑会与MAUI的原生控件初始化流程冲突，从而触发Android.Views.InflateException。

推荐方案：改用MAUI Handler机制 #

Handler是MAUI替代Renderer的官方扩展方式，适配性更好：

1. 定义自定义SearchBar控件：

public class CustomSearchBar : SearchBar
{
    // 添加自定义属性或业务逻辑，比如自定义提示文本颜色绑定属性
    public static readonly BindableProperty HintTextColorProperty =
        BindableProperty.Create(nameof(HintTextColor), typeof(Color), typeof(CustomSearchBar), Color.Gray);

    public Color HintTextColor
    {
        get => (Color)GetValue(HintTextColorProperty);
        set => SetValue(HintTextColorProperty, value);
    }
}

2. 在Android项目中实现自定义Handler：

using Microsoft.Maui.Handlers;
using AndroidX.AppCompat.Widget;
using Microsoft.Maui.Graphics;

namespace YourAppName.Droid.Handlers
{
    public static class CustomSearchBarHandlerConfig
    {
        public static void Register()
        {
            SearchBarHandler.Mapper.AppendToMapping(nameof(CustomSearchBar), (handler, view) =>
            {
                if (view is not CustomSearchBar customBar || handler.PlatformView is not SearchView searchView)
                    return;

                // 应用自定义属性，比如设置提示文本颜色
                var hintColor = customBar.HintTextColor.ToAndroid();
                searchView.SetQueryHintTextColor(hintColor);

                // 其他自定义操作：修改搜索图标、调整输入框样式等
                var searchIcon = searchView.FindViewById<ImageView>(Resource.Id.search_mag_icon);
                searchIcon?.SetImageResource(Resource.Drawable.custom_search_icon);
            });
        }
    }
}

3. 在MauiProgram.cs中注册Handler：

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    CustomSearchBarHandlerConfig.Register();
#endif
});

过渡方案：修复旧Renderer（仅临时使用） #

若需快速过渡，可修改原Renderer代码适配MAUI的控件初始化逻辑：

[assembly: ExportRenderer(typeof(CustomSearchBar), typeof(CustomSearchBarRenderer))]
namespace YourAppName.Droid.Renderers
{
    public class CustomSearchBarRenderer : SearchBarRenderer
    {
        public CustomSearchBarRenderer(Context context) : base(context) { }

        protected override void OnElementChanged(ElementChangedEventArgs<SearchBar> e)
        {
            base.OnElementChanged(e);

            if (Control == null || e.NewElement == null)
                return;

            var searchView = Control as SearchView;
            // 移除手动Inflate布局的代码，直接操作原生SearchView的属性
            searchView.QueryHint = "自定义搜索";
            searchView.SetQueryTextColor(Android.Graphics.Color.Black);
            // 避免重复初始化布局，依赖MAUI默认的控件结构
        }
    }
}

⚠️ 注意：此方案仅作为临时过渡，MAUI后续版本可能完全移除Renderer支持，最终建议迁移到Handler。

额外排查点 #

• 检查Android项目的NuGet依赖，确保Microsoft.Maui.Controls等包版本一致，无冲突
• 清理项目的bin/obj目录，重新生成，避免旧Xamarin编译缓存引发异常

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