.NET MAUI自定义渲染器完全指南（手把手教你实现跨平台自定义控件）

什么是自定义渲染器？

自定义渲染器是.NET MAUI中用于将共享代码中的控件映射到各平台原生控件的一种机制。例如，你可以创建一个名为MyButton的共享控件，然后分别为Android和iOS编写不同的渲染器，让它们在各自平台上显示为完全不同的按钮样式或行为。

第一步：创建自定义控件

首先，在你的.NET MAUI项目中创建一个新的类，继承自View或已有控件：

// MyCustomView.csnamespace MyMauiApp.Controls{    public class MyCustomView : View    {        // 可选：添加自定义属性        public static readonly BindableProperty TextProperty =            BindableProperty.Create(nameof(Text), typeof(string), typeof(MyCustomView), string.Empty);        public string Text        {            get => (string)GetValue(TextProperty);            set => SetValue(TextProperty, value);        }    }}

第二步：为Android平台创建渲染器

在Platforms/Android目录下创建一个新的类：

// Platforms/Android/Renderers/MyCustomViewRenderer.csusing Android.Content;using Android.Widget;using Microsoft.Maui.Controls.Platform;using MyMauiApp.Controls;using MyMauiApp.Platforms.Android.Renderers;[assembly: ExportRenderer(typeof(MyCustomView), typeof(MyCustomViewRenderer))]namespace MyMauiApp.Platforms.Android.Renderers{    public class MyCustomViewRenderer : ViewRenderer<MyCustomView, TextView>    {        public MyCustomViewRenderer(Context context) : base(context)        {        }        protected override void OnElementChanged(ElementChangedEventArgs<MyCustomView> e)        {            base.OnElementChanged(e);            if (Control == null)            {                var textView = new TextView(Context)                {                    Text = e.NewElement?.Text ?? "Default Text",                    TextSize = 20                };                SetNativeControl(textView);            }            if (e.NewElement != null)            {                Control.Text = e.NewElement.Text;            }        }        protected override void OnElementPropertyChanged(object sender, System.ComponentModel.PropertyChangedEventArgs e)        {            base.OnElementPropertyChanged(sender, e);            if (e.PropertyName == nameof(MyCustomView.Text))            {                Control.Text = Element.Text;            }        }    }}

第三步：为iOS平台创建渲染器

在Platforms/iOS目录下创建渲染器：

// Platforms/iOS/Renderers/MyCustomViewRenderer.csusing Microsoft.Maui.Controls.Platform;using MyMauiApp.Controls;using MyMauiApp.Platforms.iOS.Renderers;using UIKit;[assembly: ExportRenderer(typeof(MyCustomView), typeof(MyCustomViewRenderer))]namespace MyMauiApp.Platforms.iOS.Renderers{    public class MyCustomViewRenderer : ViewRenderer<MyCustomView, UILabel>    {        protected override void OnElementChanged(ElementChangedEventArgs<MyCustomView> e)        {            base.OnElementChanged(e);            if (Control == null)            {                var label = new UILabel                {                    Text = e.NewElement?.Text ?? "Default Text",                    Font = UIFont.SystemFontOfSize(20)                };                SetNativeControl(label);            }            if (e.NewElement != null)            {                Control.Text = e.NewElement.Text;            }        }        protected override void OnElementPropertyChanged(object sender, System.ComponentModel.PropertyChangedEventArgs e)        {            base.OnElementPropertyChanged(sender, e);            if (e.PropertyName == nameof(MyCustomView.Text))            {                Control.Text = Element.Text;            }        }    }}

第四步：在XAML中使用自定义控件

现在你可以在页面中使用这个控件了：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"             xmlns:controls="clr-namespace:MyMauiApp.Controls"             x:Class="MyMauiApp.MainPage">    <VerticalStackLayout Padding="20">        <controls:MyCustomView Text="Hello from Custom Renderer!" />    </VerticalStackLayout></ContentPage>

注意事项与最佳实践

• 确保使用[assembly: ExportRenderer]特性注册渲染器。
• 处理好内存释放，避免内存泄漏（特别是在Android中）。
• 尽量复用已有控件的渲染器逻辑，减少重复代码。
• 对于简单样式定制，优先考虑使用Handler（.NET MAUI推荐的新方式），但对于复杂原生交互，渲染器仍是强大工具。

总结

通过本教程，你已经掌握了如何在.NET MAUI中使用自定义渲染器来实现跨平台的原生控件定制。这项技能对于需要深度平台集成的MAUI跨平台开发项目非常关键。记住，虽然.NET MAUI推荐使用Handlers作为新范式，但在某些场景下，C#自定义渲染器依然是不可替代的强大工具。

希望这篇关于.NET MAUI自定义渲染器的教程对你有所帮助！动手试试吧，你会发现它并没有想象中那么难。