如何在.NET MAUI ContentPage中嵌入Android原生XML布局控件？

第一步：修正布局文件位置 #

先把你的Test2.xml从Platforms/Android/Resources/drawable目录移到Platforms/Android/Resources/layout目录——drawable是存放图片、形状等资源的，Android布局文件必须放在layout目录下，同时确保文件的Build Action设置为AndroidResource（右键文件→属性可修改）。

方法一：通过自定义View+Handler实现（适合跨平台封装场景） #

如果需要在跨平台页面中统一使用这个原生布局，用这种方式更规范：

1. 创建跨平台自定义View
   在共享项目中新建类：

namespace YourAppNamespace;

public class AndroidNativeLayoutView : View
{
}

2. 实现Android平台的Handler
   在Platforms/Android目录下新建Handler类：

using Android.Views;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.Android;

public class AndroidNativeLayoutViewHandler : ViewHandler<AndroidNativeLayoutView, View>
{
    protected override View CreatePlatformView()
    {
        // 加载原生布局文件
        var inflater = LayoutInflater.FromContext(Context);
        return inflater.Inflate(Resource.Layout.Test2, null);
    }

    // 可选：如果需要给布局内的控件绑定事件，重写此方法
    protected override void ConnectHandler(View platformView)
    {
        base.ConnectHandler(platformView);
        // 示例：找到布局内的Button并绑定点击事件
        var btn = platformView.FindViewById<Android.Widget.Button>(Resource.Id.your_button_id);
        btn?.Click += (s, e) =>
        {
            // 处理点击逻辑
        };
    }
}

3. 注册Handler
   在Platforms/Android/MainApplication.cs的OnCreate方法中添加注册逻辑：

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    // 注册自定义View的Handler
    ViewHandler.ViewMapper.AppendToMapping(nameof(AndroidNativeLayoutView), (handler, view) =>
    {
        if (handler is AndroidNativeLayoutViewHandler)
        {
            // 可添加额外初始化逻辑
        }
    });
}

4. 在MAUI XAML中使用

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:YourAppNamespace"
             x:Class="YourAppNamespace.MainPage">

    <local:AndroidNativeLayoutView />

</ContentPage>

方法二：直接在C#代码中加载（仅Android平台使用场景） #

如果不需要跨平台，直接在页面后台代码中动态加载原生布局更简单：

using Android.Views;
using Microsoft.Maui.Platform;

namespace YourAppNamespace;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();

        if (DeviceInfo.Current.Platform == DevicePlatform.Android)
        {
            var mauiContext = Handler?.MauiContext;
            if (mauiContext != null)
            {
                var inflater = LayoutInflater.FromContext(mauiContext.Context);
                // 加载原生布局
                var nativeLayout = inflater.Inflate(Resource.Layout.Test2, null);
                // 把原生View包装成MAUI可识别的View
                var mauiView = nativeLayout.ToPlatform(mauiContext);
                // 设置为页面内容
                Content = mauiView;
            }
        }
    }
}

关键说明 #

• Handler的核心作用是把MAUI的抽象View映射到平台原生控件，CreatePlatformView负责创建原生控件实例，ConnectHandler用于后续的事件绑定、属性同步等操作。
• 如果布局内有需要动态修改的元素，都可以通过PlatformView.FindViewById<控件类型>(资源ID)的方式获取并操作。

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