Flutter真机iPad无法修改设备方向问题求助

问题原因 #

这个错误（UISceneErrorDomain Code=101）是因为iPad处于分屏、Slide Over或悬浮窗口模式时，iOS系统会限制应用以编程方式修改界面方向——这些窗口模式下，界面方向由系统统一管理，不允许应用强制更改。而iPhone模拟器/Android没有这类多窗口限制，所以功能正常。

解决方案 #

1. 确保应用处于全屏模式 #

测试时先退出iPad的分屏/Slide Over模式：

• 拖动应用窗口边缘至屏幕最左侧/右侧，直到窗口占满整个屏幕；
• 或者上滑进入多任务界面，点击应用卡片顶部的「全屏」按钮。

2. 修改iOS项目配置 #

在Flutter项目的ios/Runner/Info.plist中，确认以下配置：

• 确保添加了iPad支持的所有方向：

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

• 若应用不需要支持多窗口，可直接禁用该功能：
  添加以下配置到Info.plist：

<key>UIApplicationSupportsMultipleScenes</key>
<false/>

或者在Xcode项目设置的「Deployment Info」→「iPad」中，取消勾选「Supports multiple windows」。

3. 代码层面容错适配 #

在设置方向前捕获错误，针对多窗口场景做降级处理：

void _toggleFullScreen() async {
  await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
  try {
    await SystemChrome.setPreferredOrientations(const [
      DeviceOrientation.landscapeLeft,
      DeviceOrientation.landscapeRight,
    ]);
  } catch (e) {
    debugPrint("切换横屏失败：$e");
    // 可选：提示用户退出分屏模式后重试
  }
}

void _togglePortrait() async {
  await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
  try {
    await SystemChrome.setPreferredOrientations(const [
      DeviceOrientation.portraitUp,
      DeviceOrientation.portraitDown,
    ]);
  } catch (e) {
    debugPrint("切换竖屏失败：$e");
  }
}

4. 多窗口场景的iOS原生适配（可选） #

如果应用需要保留多窗口支持，可在iOS的SceneDelegate.swift中添加方向逻辑：

func windowScene(_ windowScene: UIWindowScene, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask {
    // 全屏时允许所有方向，分屏时跟随系统限制
    if windowScene.sizeRestrictions?.minimumSize == windowScene.screen.bounds.size {
        return .all
    } else {
        return .allButUpsideDown
    }
}

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