Flutter开发Android应用：隐藏导航栏与状态栏失效及IDE警告问题

1. 消除IDE的await警告 #

SystemChrome.setEnabledSystemUIMode方法返回Future类型，必须添加await才能消除警告；WidgetsFlutterBinding.ensureInitialized()是同步方法，无需await。

修正后的main方法代码：

Future<void> main(List<String> args) async {
  // 初始化Flutter绑定
  WidgetsFlutterBinding.ensureInitialized();
  // 调用系统UI设置并添加await
  await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
  
  final container = await preInit(args);

  runApp(RefenaScope.withContainer(
    container: container,
    child: TranslationProvider(
      child: const LocalSendApp(),
    ),
  ));
}

2. 解决导航栏/状态栏未隐藏的问题 #

仅在main中调用系统UI设置可能会被后续页面渲染、组件逻辑重置，可通过以下方式加固：

方式一：在根组件的initState中重复设置 #

修改LocalSendApp组件，在初始化阶段再次调用系统UI设置：

class LocalSendApp extends StatefulWidget {
  const LocalSendApp({super.key});

  @override
  State<LocalSendApp> createState() => _LocalSendAppState();
}

class _LocalSendAppState extends State<LocalSendApp> {
  @override
  void initState() {
    super.initState();
    // 延迟执行确保页面渲染完成后生效
    Future.delayed(const Duration(milliseconds: 100), () {
      SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
    });
  }

  @override
  Widget build(BuildContext context) {
    // 原组件构建逻辑
    return MaterialApp(...);
  }
}

方式二：使用PostFrameCallback在runApp后执行 #

在main方法中，页面渲染完成后再次触发系统UI设置：

Future<void> main(List<String> args) async {
  WidgetsFlutterBinding.ensureInitialized();
  await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
  
  final container = await preInit(args);

  runApp(RefenaScope.withContainer(
    container: container,
    child: TranslationProvider(
      child: const LocalSendApp(),
    ),
  ));

  // 页面渲染完成后再次设置
  WidgetsBinding.instance.addPostFrameCallback((_) {
    SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
  });
}

额外优化 #

如果需要彻底隐藏状态栏文字等元素，可配合设置覆盖层参数：

await SystemChrome.setEnabledSystemUIMode(
  SystemUiMode.immersiveSticky,
  overlays: [], // 隐藏所有系统覆盖层
);

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