Flutter应用在Android模拟器及实体机上不显示手机状态栏如何解决
Flutter Android端状态栏无法显示的排查与解决方案
1 Flutter层配置排查
- 搜索项目中是否调用了
SystemChrome.setEnabledSystemUIMode方法,如果传入参数为SystemUiMode.immersive、SystemUiMode.immersiveSticky、SystemUiMode.leanback,都会主动隐藏状态栏,修改为SystemUiMode.edgeToEdge或删除相关代码即可恢复显示。 - 检查页面
AppBar的systemOverlayStyle配置,如果statusBarColor设置为透明,且statusBarIconBrightness和页面背景色接近,会出现状态栏内容和背景融合的视觉效果,调整为和背景对比度足够的亮度值即可。 - 检查
Scaffold组件的extendBodyBehindAppBar属性是否为true且未配置AppBar,此时页面内容会顶到屏幕顶部覆盖状态栏,要么关闭该属性,要么给页面顶部添加对应状态栏高度的边距。 - 排查是否引入了全屏类第三方插件,部分插件默认会隐藏状态栏,可查看插件配置项手动开启状态栏显示。
2 Android原生层配置排查
- 打开
android/app/src/main/res/values/styles.xml文件,检查App主题中是否存在<item name="android:windowFullscreen">true</item>配置,将值改为false或直接删除该配置项。 - 检查
AndroidManifest.xml中Activity节点的android:theme属性是否引用了全屏主题,替换为普通的AppCompat或MaterialComponents主题即可。 - 排查是否存在原生层自定义代码调用了
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN),删除该代码段即可。
3 修复验证步骤
修改完成后先执行flutter clean清理项目缓存,再重新编译运行应用,分别在模拟器和实体机的浅色/深色模式下测试,确认状态栏显示正常。
4 沉浸式状态栏适配方案
如果需要实现沉浸式状态栏效果,不要直接隐藏状态栏,可参考以下配置:
// 全局设置状态栏样式 SystemChrome.setSystemUIOverlayStyle( const SystemUiOverlayStyle( statusBarColor: Colors.transparent, // 浅色背景用Brightness.dark,深色背景用Brightness.light statusBarIconBrightness: Brightness.dark, statusBarBrightness: Brightness.light, ), );
页面内容使用SafeArea组件包裹,避免内容被状态栏遮挡。
内容的提问来源于stack exchange,提问作者Mike Zero
相关产品推荐
相关产品推荐

