如何解决Edge-to-Edge使用中已弃用API/参数的报错问题？

问题根源分析 #

你的代码存在三个核心问题，直接触发了Google Play Console的弃用警告：

1. 使用了已弃用的systemNavigationBarDividerColor参数（Android 12+不再支持导航栏分隔线，Flutter已标记该参数为弃用）；
2. customOverlayStyle()函数未返回SystemUiOverlayStyle实例，导致AnnotatedRegion获取无效样式值；
3. 系统UI模式设置与样式配置的位置不合理，可能引发重复调用或兼容性问题。

修复步骤及代码调整 #

1. 修复样式函数，移除弃用参数

修改customOverlayStyle()函数，确保返回有效样式实例并删除弃用参数：

SystemUiOverlayStyle customOverlayStyle() {
  return SystemUiOverlayStyle(
    systemNavigationBarColor: Colors.transparent,
    statusBarColor: Colors.transparent,
    // 根据界面主题设置图标亮度，确保透明栏下图标可见
    statusBarIconBrightness: Brightness.dark,
    systemNavigationBarIconBrightness: Brightness.dark,
  );
}

2. 正确设置系统UI模式

将SystemChrome.setEnabledSystemUIMode(SystemUiMode.edgeToEdge)移至页面的initState()生命周期方法中，避免在样式函数中重复调用：

@override
void initState() {
  super.initState();
  // 初始化时设置Edge-to-Edge模式
  SystemChrome.setEnabledSystemUIMode(SystemUiMode.edgeToEdge);
}

3. 保留原有界面结构的正确配置

你的build()方法中Scaffold的extendBody、extendBodyBehindAppBar以及SafeArea的设置是正确的，无需修改，最终完整的build方法如下：

Widget build(BuildContext context) {
  return AnnotatedRegion<SystemUiOverlayStyle>(
    value: customOverlayStyle(),
    child: SafeArea(
      top: false,
      bottom: false,
      child: Scaffold(
        resizeToAvoidBottomInset: false,
        extendBodyBehindAppBar: true,
        extendBody: true,
        appBar: AppBar(
          title: Padding(
            padding: const EdgeInsets.only(left: 0),
            child: const Text('MyTitle'),
          ),
        ),
        body: ResponsiveCenter(
          controller: ScrollController(
            keepScrollOffset: true,
            initialScrollOffset: 0,
          ),
          maxContentWidth: App.maxBodyWidth,
          child: Column(children: <Widget>[]),
        ),
      ),
    ),
  );
}

修复流程解释 #

• 移除弃用参数：systemNavigationBarDividerColor是Google Play Console检测到的直接弃用项，删除后即可消除该部分警告；
• 修复返回值：确保AnnotatedRegion能获取到有效的系统UI样式，避免因无效值引发的隐性兼容性问题；
• 规范生命周期调用：将系统UI模式设置放在initState()中，符合Flutter组件生命周期的最佳实践，避免重复调用导致的异常；
• 补充图标亮度配置：透明状态栏/导航栏下必须设置图标亮度，否则会出现图标与背景融合的显示问题，同时完善的样式配置也能减少平台兼容性警告。

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