Flutter如何跳过或加速横竖屏切换时的屏幕旋转动画

系统旋转动画的控制权限说明 #

SystemChrome.setPreferredOrientations触发的屏幕旋转动画是系统原生层全局控制的，Flutter 没有提供跨平台的公开API来直接调整该动画速度、或跳过动画：

• 安卓端动画逻辑由厂商系统定制，部分厂商会在旋转时增加额外的过渡特效，本身就会加重渲染负载
• iOS端系统没有给第三方应用开放修改旋转动画参数的权限
  中低端设备卡顿的核心原因是：系统旋转动画和Flutter页面跳转动画同时执行时，GPU/CPU负载过高导致掉帧。

可落地的优化手段 #

• 错开动画执行时机：不要在路由push/pop动画执行过程中调用setPreferredOrientations，要么在路由构建前提前1~2帧设置目标方向，要么等页面入场动画完全执行结束后再触发方向切换，避免两个动画抢占渲染资源。
• 安卓端原生层屏蔽旋转动画：在安卓项目的AndroidManifest.xml中，给主Activity添加android:configChanges="orientation|screenSize|keyboardHidden"配置，拦截系统默认的Activity重建流程；之后在MainActivity中重写配置变更回调，将窗口动画时长临时设为0即可跳过旋转过渡。iOS端无公开方案实现该效果。
  代码示例（安卓MainActivity Kotlin）：

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    // 配置变更时临时禁用窗口动画
    window.setWindowAnimations(0)
}

不调用setPreferredOrientations的替代实现 #

• 方案1（推荐，跨平台无卡顿）：Widget层自实现旋转
  全局将应用方向固定为竖屏，完全不触发系统层面的方向变更，在需要横屏的页面用RotatedBox直接旋转页面根节点，同时手动修正MediaQuery参数适配横屏布局。所有旋转逻辑在Flutter渲染层内部完成，没有系统动画开销，中低端设备也能实现无卡顿切换。
  代码示例：

  // 应用启动时全局锁竖屏，后续不再调用setPreferredOrientations修改方向
  void main() {
    WidgetsFlutterBinding.ensureInitialized();
    SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
    runApp(const MyApp());
  }
  
  // 横屏游戏页面实现
  class GamePage extends StatelessWidget {
    @override
    Widget build(BuildContext context) {
      final originSize = MediaQuery.of(context).size;
      return RotatedBox(
        quarterTurns: 1, // 1=顺时针转90度（左横屏），3=顺时针转270度（右横屏）
        child: MediaQuery(
          data: MediaQuery.of(context).copyWith(
            size: Size(originSize.height, originSize.width),
            orientation: Orientation.landscape,
          ),
          child: Scaffold(
            // 游戏页面正常写横屏布局即可
            body: const Center(child: Text("游戏内容")),
          ),
        ),
      );
    }
  }
  

• 方案2：独立原生页承载横屏内容
  为横屏游戏模块单独配置一个固定横屏方向的原生Activity，普通应用页面保留在默认竖屏的Flutter主Activity中，跳转时直接在原生层启动新Activity。由于新Activity的方向是在Manifest中预先固定的，启动时不会触发动态旋转动画，只会走原生Activity的启动动画，不会出现旋转过程卡顿。缺点是跨Activity传递数据的实现成本比Flutter内部路由高。

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