Flutter按屏幕锁定屏幕方向在iPad上失效问题求助

问题原因 #

iPad默认支持多窗口（分屏、滑过）特性，系统对屏幕方向的限制逻辑比iPhone更严格。仅在initState中设置SystemChrome.setPreferredOrientations，可能因页面初始化时机与系统窗口状态不匹配，导致旋转后黑屏。

解决方案 #

方案1：关闭iPad多窗口支持（最简单） #

如果你的应用不需要多窗口功能，可在iOS的Info.plist中添加以下配置，让应用强制全屏运行，此时方向锁定逻辑将与iPhone一致：

<key>UIRequiresFullScreen</key>
<true/>

方案2：在didChangeDependencies中设置方向 #

initState执行时页面上下文尚未完全初始化，在didChangeDependencies中设置方向，时机更适配iPad的窗口状态：

@override
void didChangeDependencies() {
  super.didChangeDependencies();
  SystemChrome.setPreferredOrientations([
    DeviceOrientation.portraitUp,
    DeviceOrientation.portraitDown,
  ]);
}

方案3：监听方向变化并重新锁定 #

若需保留多窗口功能，可通过WidgetsBindingObserver监听屏幕方向变化，主动纠正锁定方向：

class SettingsScreen extends StatefulWidget {
  @override
  _SettingsScreenState createState() => _SettingsScreenState();
}

class _SettingsScreenState extends State<SettingsScreen> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    _lockPortrait();
  }

  void _lockPortrait() {
    SystemChrome.setPreferredOrientations([
      DeviceOrientation.portraitUp,
      DeviceOrientation.portraitDown,
    ]);
  }

  @override
  void didChangeMetrics() {
    super.didChangeMetrics();
    // 屏幕尺寸/方向变化后重新锁定竖屏
    _lockPortrait();
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // 你的设置页面内容
    );
  }
}

主应用横屏设置 #

进入主应用页面时，用同样逻辑设置横屏方向：

SystemChrome.setPreferredOrientations([
  DeviceOrientation.landscapeLeft,
  DeviceOrientation.landscapeRight,
]);

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