Xamarin.Forms Android如何全局适配屏幕宽高并解决导航栏遮挡问题

我之前也碰到过完全一样的问题，一个个页面去调整Padding或者写OnPlatform真的太折腾人了，这里有几个全局解决方案，不用逐个视图修改就能搞定：

方案1：在Android项目的MainActivity中全局配置窗口属性 #

这是最直接的方法，通过配置Android窗口的布局规则，让Xamarin.Forms的页面自动避开系统栏：

打开Android项目里的MainActivity.cs，修改OnCreate方法：

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);

    // 让页面布局延伸到系统栏下方，但自动预留安全区域
    Window.DecorView.SystemUiVisibility = (StatusBarVisibility)(SystemUiFlags.LayoutStable | SystemUiFlags.LayoutFullscreen | SystemUiFlags.LayoutHideNavigation);
    
    // Android 11+ 用InsetsController做更灵活的控制
    if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
    {
        Window.InsetsController?.SetSystemBarsBehavior(WindowInsetsControllerBehavior.ShowBarsBySwipe);
    }
    else
    {
        // 兼容旧版本Android的设置
        Window.SetFlags(WindowManagerFlags.LayoutNoLimits, WindowManagerFlags.LayoutNoLimits);
    }

    Xamarin.Essentials.Platform.Init(this, savedInstanceState);
    global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
    LoadApplication(new App());
}

设置完之后，所有页面的内容都会自动避开状态栏和导航栏，不需要在每个页面单独做调整。

方案2：全局自定义Page渲染器（更精细控制） #

如果需要更灵活地控制页面的安全区域，可以给所有ContentPage加一个全局渲染器：

在Android项目里创建一个CustomPageRenderer.cs文件：

using Android.Content;
using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;

// 给所有ContentPage应用这个渲染器
[assembly: ExportRenderer(typeof(ContentPage), typeof(YourAppNamespace.Droid.Renderers.CustomPageRenderer))]
namespace YourAppNamespace.Droid.Renderers
{
    public class CustomPageRenderer : PageRenderer
    {
        public CustomPageRenderer(Context context) : base(context)
        {
        }

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

            if (e.NewElement != null)
            {
                // 获取系统栏的安全区域边距
                var insets = Window.DecorView.RootWindowInsets;
                if (insets != null)
                {
                    var topInset = insets.StableInsetTop;
                    var bottomInset = insets.StableInsetBottom;
                    
                    // 给页面设置Padding，避开状态栏和导航栏
                    e.NewElement.Padding = new Thickness(0, topInset, 0, bottomInset);
                }
            }
        }
    }
}

这个渲染器会自动给所有ContentPage类型的页面添加对应的顶部和底部Padding，完美解决遮挡问题，而且可以根据需求修改Padding的逻辑。

方案3：用Xamarin.Essentials做跨平台全局设置 #

如果需要同时兼容iOS和Android，不想写平台特定代码，可以用Xamarin.Essentials的安全区域API，在App.xaml.cs里全局处理：

public App()
{
    InitializeComponent();

    // 监听所有页面的PageAppearing事件，全局设置安全区域Padding
    Application.Current.PageAppearing += (sender, e) =>
    {
        if (e.Page is ContentPage page)
        {
            var safeArea = Xamarin.Essentials.DeviceDisplay.MainDisplayInfo.SafeArea;
            
            // 把页面Padding设置为安全区域的边距
            page.Padding = new Thickness(
                safeArea.Left,
                safeArea.Top,
                safeArea.Right,
                safeArea.Bottom
            );
        }
    };
}

这个方法是跨平台的，iOS和Android都会自动应用对应的安全区域边距，不用写OnPlatform语句，非常省心。

小提醒 #

• 如果用了NavigationPage，默认开启导航栏的情况下，顶部Padding会自动适配，但如果隐藏了导航栏，上面的方案依然有效。
• 方案1里的旧版本兼容代码可以确保Android 10及以下的设备正常工作。

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