迁移Xamarin至MAUI时Compatibility.Layout<T>无显示问题求助

问题原因 #

1. MauiContext初始化时机差异：MAUI兼容性层中，控件的MauiContext需在控件被添加到可视化树（父视图设置完成）后才会赋值。Xamarin.Forms允许在构造函数中直接添加子视图，但MAUI中此时子视图无法获取有效上下文，导致Handler创建失败（WinUI3抛出The handler's MauiContext cannot be null.）或视图无法渲染（Android无内容）。
2. 子视图未触发测量流程：原代码中MeasureOverride直接返回固定尺寸，未触发子视图的测量逻辑，导致子视图的布局信息未初始化，无法正常渲染。

解决方案 #

修改自定义布局的子视图添加时机，并补充子视图测量逻辑：

修改后的CustomVerticalStackLayout代码 #

using Microsoft.Maui.Controls.Compatibility;

namespace MauiApp2
{
    public class CustomVerticalStackLayout : Layout<View>
    {
        private readonly Label lbl;

        public CustomVerticalStackLayout()
        {
            lbl = new Label { Text = "test", FontSize = 20, BackgroundColor = Colors.Red, HeightRequest = 100, WidthRequest = 100, Margin = 20 };
            BackgroundColor = Colors.Blue;
        }

        protected override void OnParentSet()
        {
            base.OnParentSet();
            if (!Children.Contains(lbl))
            {
                Children.Add(lbl);
            }
        }

        protected override Size MeasureOverride(double widthConstraint, double heightConstraint)
        {
            // 先测量子视图，触发其布局初始化
            lbl.Measure(widthConstraint, heightConstraint);
            // 返回自定义布局尺寸
            return new Size(200, 200);
        }

        protected override void LayoutChildren(double x, double y, double width, double height)
        {
            // 考虑子视图Margin，调整布局区域
            var childRect = new Rect(
                x + lbl.Margin.Left,
                y + lbl.Margin.Top,
                150 - lbl.Margin.HorizontalThickness,
                150 - lbl.Margin.VerticalThickness);
            LayoutChildIntoBoundingRegion(lbl, childRect);
        }
    }

    public class CustomControl : ContentView
    {
        public CustomControl()
        {
            this.BackgroundColor = Colors.Green;
            this.Padding = new Thickness(30);
            this.Content = new CustomVerticalStackLayout();
        }

        protected override Size MeasureOverride(double widthConstraint, double heightConstraint)
        {
            return new Size(230, 230);
        }
    }
}

关键修改说明 #

• 延迟子视图添加：将子视图lbl的添加逻辑移至OnParentSet方法，确保控件已关联父视图、MauiContext已初始化，子视图能正常创建Handler。
• 手动触发子视图测量：在MeasureOverride中调用lbl.Measure()，强制子视图完成自身的尺寸计算，避免因未测量导致的渲染异常。
• 修正布局区域计算：布局子视图时考虑其Margin属性，确保视图位置和尺寸符合预期，避免被裁剪。

额外验证 #

确保MauiProgram.cs中已正确启用兼容性模式：

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCompatibility() // 必须保留此配置
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
    });

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