如何实现Xamarin.Forms共享项目指定页面固定横屏（适配Android、iOS）？

当然有可行的方案！要让指定页面进入横屏并保持状态，得结合Xamarin.Forms的共享代码和平台特定的自定义渲染器来做——毕竟横竖屏控制是平台级的操作，没法完全在共享层搞定。下面一步步给你拆解：

1. 共享项目层：标记需要横屏的页面 #

首先在共享项目里，咱们可以用一个标记接口来标识哪些页面需要强制横屏，这样平台渲染器能精准识别目标页面：

// 定义标记接口，不需要实现任何方法
public interface ILandscapeLockedPage { }

然后让你的目标页面实现这个接口：

public class TargetLandscapePage : ContentPage, ILandscapeLockedPage
{
    // 这里写你的页面布局和逻辑
    public TargetLandscapePage()
    {
        Content = new Label { Text = "我是横屏页面！", HorizontalOptions = LayoutOptions.Center, VerticalOptions = LayoutOptions.Center };
    }
}

2. Android平台实现 #

在Android项目里，咱们需要写一个自定义页面渲染器，接管目标页面的生命周期，强制设置横屏，并在页面销毁时恢复原方向：

步骤2.1 编写页面渲染器 #

在Android项目中创建一个Renderers文件夹，添加以下代码：

[assembly: ExportRenderer(typeof(ILandscapeLockedPage), typeof(LandscapePageRenderer))]
namespace YourAppNamespace.Droid.Renderers
{
    public class LandscapePageRenderer : PageRenderer
    {
        // 保存页面进入前的原始方向
        private ScreenOrientation _originalOrientation;

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

            if (e.NewElement != null)
            {
                // 获取当前Activity并保存原始方向
                var currentActivity = (Activity)Context;
                _originalOrientation = currentActivity.RequestedOrientation;
                // 强制设置为横屏
                currentActivity.RequestedOrientation = ScreenOrientation.Landscape;
            }
            else if (e.OldElement != null)
            {
                // 页面销毁时恢复原始方向
                ((Activity)Context).RequestedOrientation = _originalOrientation;
            }
        }
    }
}

步骤2.2 配置AndroidManifest #

确保你的MainActivity允许横竖屏切换，避免页面重启。在MainActivity的特性中添加ConfigurationChanges参数：

[Activity(
    Label = "YourAppName", 
    Icon = "@mipmap/icon", 
    Theme = "@style/MainTheme", 
    MainLauncher = true,
    // 关键：添加这些配置，防止横竖屏切换时重启Activity
    ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize
)]
public class MainActivity : global::Xamarin.Forms.Platform.Android.FormsAppCompatActivity
{
    // ... 其他代码
}

3. iOS平台实现 #

iOS的横竖屏控制逻辑和Android略有不同，需要处理页面生命周期、状态栏方向，还要适配iOS 16+的新API：

步骤3.1 编写页面渲染器 #

在iOS项目中创建Renderers文件夹，添加以下代码：

[assembly: ExportRenderer(typeof(ILandscapeLockedPage), typeof(LandscapePageRenderer))]
namespace YourAppNamespace.iOS.Renderers
{
    public class LandscapePageRenderer : PageRenderer
    {
        public override void ViewWillAppear(bool animated)
        {
            base.ViewWillAppear(animated);

            // 强制设置横屏方向（这里选左横屏，你也可以换成LandscapeRight）
            UIApplication.SharedApplication.StatusBarOrientation = UIInterfaceOrientation.LandscapeLeft;

            // 适配iOS 16+的新API
            if (UIDevice.CurrentDevice.CheckSystemVersion(16, 0))
            {
                var windowScene = UIApplication.SharedApplication.ConnectedScenes.OfType<UIWindowScene>().FirstOrDefault();
                windowScene?.RequestGeometryUpdate(new UIWindowSceneGeometryPreferencesIOS(UIInterfaceOrientationMask.LandscapeLeft));
            }
        }

        public override void ViewWillDisappear(bool animated)
        {
            base.ViewWillDisappear(animated);

            // 离开页面时恢复竖屏（或者根据需求恢复原始方向）
            UIApplication.SharedApplication.StatusBarOrientation = UIInterfaceOrientation.Portrait;

            // 适配iOS 16+
            if (UIDevice.CurrentDevice.CheckSystemVersion(16, 0))
            {
                var windowScene = UIApplication.SharedApplication.ConnectedScenes.OfType<UIWindowScene>().FirstOrDefault();
                windowScene?.RequestGeometryUpdate(new UIWindowSceneGeometryPreferencesIOS(UIInterfaceOrientationMask.Portrait));
            }
        }

        // 限制当前页面只允许横屏
        public override UIInterfaceOrientationMask GetSupportedInterfaceOrientations()
        {
            return UIInterfaceOrientationMask.LandscapeLeft | UIInterfaceOrientationMask.LandscapeRight;
        }

        // 禁止自动旋转，保持横屏状态
        public override bool ShouldAutorotate()
        {
            return false;
        }
    }
}

步骤3.2 配置Info.plist #

确保iOS应用允许横屏方向，打开Info.plist，添加以下配置（如果没有的话）：

<key>UISupportedInterfaceOrientations</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>
<key>UISupportedInterfaceOrientations~ipad</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationPortraitUpsideDown</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>

4. 测试验证 #

现在导航到TargetLandscapePage，你会发现页面自动切换到横屏，并且即使旋转设备也不会变回竖屏；当你离开这个页面（比如返回上一页），应用会恢复到之前的方向。

额外注意点 #

• 如果你的页面嵌套在NavigationPage或TabbedPage中，可能需要调整渲染器的目标类型（比如针对NavigationPage的渲染器做处理），不过上面的标记接口方案通常能覆盖大多数场景。
• Android上如果应用有全屏主题，可能需要额外处理状态栏的显示逻辑。
• iOS上如果是iPad应用，可能需要根据需求调整支持的方向组合。

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