.NET MAUI：MauiContext是什么？Android场景下如何获取？

一、MauiContext 是什么 #

• MauiContext 是 MAUI 中连接跨平台代码与原生平台代码的核心上下文对象，包含当前平台的关键服务、Activity、Handler 等实例，是跨平台控件转原生控件的必要参数。

二、ContentPage.Handler 为 null 的原因 #

• ContentPage 只有加载到可视化树中后，Handler 才会被初始化。如果你的 ContentPage 是新创建还未显示的，Handler 自然为 null，这是核心问题。

三、正确实现方案 #

步骤1：获取可靠的 MauiContext #

有两种稳定的获取方式：

• 从当前已显示的页面 Handler 获取：

  var mauiContext = this.Handler.MauiContext; // this 指代当前已加载的 Page
  

• 从全局 Activity 获取：

  var mauiContext = Platform.CurrentActivity?.GetMauiContext();
  

步骤2：完整的 ShowCustomDialog 实现 #

先手动初始化未加载 ContentPage 的 Handler，再转换为原生 View：

public partial void ShowCustomDialog(ContentPage contentPage)
{
    var mauiContext = Platform.CurrentActivity?.GetMauiContext();
    if (mauiContext == null) return;

    // 手动初始化未加载页面的 Handler
    if (contentPage.Handler == null)
    {
        contentPage.Handler = new Microsoft.Maui.Handlers.PageHandler();
        contentPage.Handler.SetMauiContext(mauiContext);
        contentPage.Loaded += (s, e) => {}; // 触发页面加载逻辑
    }

    // 转换为 Android 原生 View
    if (contentPage.ToPlatform(mauiContext) is Android.Views.View androidView)
    {
        var customDialogFragment = new CustomDialogFragment();
        if (customDialogFragment != null && Platform.CurrentActivity is Activity currentActivity)
        {
            customDialogFragment.Container.AddView(androidView);
            customDialogFragment.Show(currentActivity.FragmentManager.BeginTransaction(), "CustomDialogTag");
        }
    }
}

步骤3：CustomDialogFragment 基础实现 #

需要提供容器布局承载转换后的 View：

public class CustomDialogFragment : AndroidX.Fragment.App.DialogFragment
{
    public LinearLayout Container { get; private set; }

    public override Android.Views.View OnCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
    {
        Container = new LinearLayout(inflater.Context);
        Container.LayoutParameters = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MatchParent, ViewGroup.LayoutParams.WrapContent);
        Container.Orientation = Orientation.Vertical;
        return Container;
    }

    public override void OnStart()
    {
        base.OnStart();
        // 设置弹窗宽度适配屏幕
        Dialog.Window.SetLayout(ViewGroup.LayoutParams.MatchParent, ViewGroup.LayoutParams.WrapContent);
    }
}

四、注意事项 #

• 不要直接使用未加载的 ContentPage 调用 ToPlatform，必须确保 Handler 已初始化。
• 获取 MauiContext 后要做空值判断，避免空引用异常。
• 优先从当前已显示页面的 Handler 获取 MauiContext，稳定性更高。

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