基于Expo屏幕方向插件，解决iPadOS强制Portrait模式失效问题

针对iPadOS分屏模式导致app.json中orientation: portrait失效的问题，以下是几个可行的解决办法：

1. 配置iPad专属的屏幕方向列表 #

直接在app.json的iOS配置中指定iPad支持的界面方向，覆盖系统默认逻辑：

{
  "expo": {
    // 原有配置
    "orientation": "portrait",
    "ios": {
      "infoPlist": {
        "UISupportedInterfaceOrientations~ipad": [
          "UIInterfaceOrientationPortrait",
          "UIInterfaceOrientationPortraitUpsideDown"
        ]
      }
    }
  }
}

这个配置会写入iOS的Info.plist文件，明确告诉系统iPad端仅支持竖屏方向，不受分屏功能干扰。

2. 运行时通过Screen Orientation API锁定方向 #

在App启动阶段调用Expo的屏幕方向API，强制锁定竖屏：

import { ScreenOrientation } from 'expo-screen-orientation';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    const lockPortrait = async () => {
      await ScreenOrientation.lockAsync(
        ScreenOrientation.OrientationLock.PORTRAIT
      );
    };
    lockPortrait();
  }, []);

  // 你的App组件内容
}

建议将这个逻辑放在根组件的初始化钩子中，确保App加载后立即生效。如果结合上面的plist配置，能进一步提升可靠性。

3. 强制App全屏运行（禁用分屏/滑过功能） #

在infoPlist中添加UIRequiresFullScreen配置，让App只能以全屏模式运行，从根源上避免分屏导致的方向问题：

{
  "expo": {
    "ios": {
      "infoPlist": {
        "UIRequiresFullScreen": true
      }
    }
  }
}

启用这个配置后，系统会禁止用户将你的App放入分屏或滑过视图，此时app.json中的orientation配置就能正常生效。

推荐组合 #

优先使用方案1 + 方案3，从系统配置层面彻底限制方向和分屏功能，再搭配方案2作为运行时的兜底保障，能最大化确保iPad端始终保持竖屏。

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