React Native Expo应用iPad端无法锁定PORTRAIT模式求助

1. 完善app.json的iOS专属配置 #

iPad默认支持多窗口模式，会导致基础的orientation配置失效，需添加iOS特定配置强制全屏并限制支持的方向：

修改后的app.json关键部分：

"expo": {
    "name": "<app name>",
    "slug": "<app name>",
    "version": "1.0.0",
    "orientation": "portrait",
    "scheme": "<scheme>",
    "icon": "./assets/icon.png",
    "userInterfaceStyle": "light",
    "plugins": [
      "@react-native-google-signin/google-signin",
      [
        "expo-screen-orientation",
        {
          "initialOrientation": "PORTRAIT_UP",
          "supportedOrientations": ["PORTRAIT_UP"]
        }
      ]
    ],
    "assetBundlePatterns": ["**/*"],
    "ios": {
      "requireFullScreen": true,
      "infoPlist": {
        "UISupportedInterfaceOrientations": [
          "UIInterfaceOrientationPortrait"
        ],
        "UISupportedInterfaceOrientations~ipad": [
          "UIInterfaceOrientationPortrait"
        ]
      }
    }
}

• requireFullScreen: 强制iPad应用全屏运行，禁用多窗口模式，这是解决问题的核心前提
• UISupportedInterfaceOrientations和UISupportedInterfaceOrientations~ipad: 明确指定仅支持竖屏方向，覆盖系统默认的多方向支持

2. 优化App.js的方向锁定逻辑 #

在现有代码基础上添加方向变化监听，确保即使出现意外方向切换也能重新锁定：

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

export default function App() {
  useEffect(() => {
    // 初始化锁定竖屏
    const lockOrientation = async () => {
      try {
        await ScreenOrientation.lockAsync(ScreenOrientation.OrientationLock.PORTRAIT_UP);
      } catch (error) {
        console.error('锁定方向失败:', error);
      }
    };

    lockOrientation();

    // 监听方向变化，异常时重新锁定
    const orientationChangeListener = ScreenOrientation.addOrientationChangeListener((event) => {
      if (event.orientationInfo.orientation !== ScreenOrientation.Orientation.PORTRAIT_UP) {
        lockOrientation();
      }
    });

    // 清理监听
    return () => {
      ScreenOrientation.removeOrientationChangeListener(orientationChangeListener);
    };
  }, []);

  // 你的应用内容...
}

3. 验证与注意事项 #

• 执行expo prebuild或eas build重新构建项目，iOS的infoPlist修改需要重新生成原生代码才能生效
• 优先使用真实iPad设备测试，模拟器可能存在部分配置不生效的情况
• Expo SDK 48.0.0版本完全兼容上述配置，无需升级SDK即可使用

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