Android中如何获取系统导航栏状态及onWillPop触发源？

方法一：通过原生通道获取系统导航模式 #

直接调用Android原生API获取用户的导航模式偏好，这是最可靠的判断方式。

Android 原生实现（Kotlin） #

在MainActivity中通过MethodChannel向Flutter传递导航模式信息：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "your_app_package/nav_mode"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getNavigationMode") {
                result.success(getSystemNavigationMode())
            } else {
                result.notImplemented()
            }
        }
    }

    private fun getSystemNavigationMode(): String {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            val uiModeManager = getSystemService(Context.UI_MODE_SERVICE) as UiModeManager
            when (uiModeManager.systemNavigationMode) {
                UiModeManager.SYSTEM_NAVIGATION_MODE_GESTURAL -> "gesture"
                UiModeManager.SYSTEM_NAVIGATION_MODE_BUTTONS -> "buttons"
                else -> "unknown"
            }
        } else {
            // Android 10及以下无官方API，默认按按键导航处理，或结合导航栏高度二次判断
            "buttons"
        }
    }
}

Flutter 端调用代码 #

封装工具类获取导航模式：

import 'package:flutter/services.dart';

class NavModeHelper {
  static const _channel = MethodChannel('your_app_package/nav_mode');

  static Future<String> getCurrentMode() async {
    try {
      return await _channel.invokeMethod('getNavigationMode') ?? 'unknown';
    } on PlatformException {
      return 'unknown';
    }
  }
}

在onWillPop中区分触发来源：

Future<bool> _handleWillPop() async {
  final navMode = await NavModeHelper.getCurrentMode();
  if (navMode == 'gesture') {
    // 侧滑返回触发，打开抽屉
    _scaffoldKey.currentState?.openDrawer();
    return false; // 阻止默认页面回退
  } else {
    // 返回按键触发，处理WebView回退
    if (await _webViewController.canGoBack()) {
      _webViewController.goBack();
      return false;
    }
    return true; // 无历史记录时允许页面回退
  }
}

方法二：监听导航栏可见性（补充方案） #

如果无法通过原生API获取导航模式，可通过监听导航栏的显示状态间接判断：

Android 原生补充代码 #

在MainActivity中监听布局变化，计算导航栏高度并通知Flutter：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    window.decorView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
        override fun onGlobalLayout() {
            val displayFrame = Rect()
            window.decorView.getWindowVisibleDisplayFrame(displayFrame)
            val screenHeight = window.decorView.rootView.height
            val navBarHeight = screenHeight - displayFrame.bottom
            // 用已知的kBottomNavigationBarHeight判断导航栏是否可见
            val isNavBarVisible = navBarHeight > kBottomNavigationBarHeight
            // 通知Flutter状态变化
            MethodChannel(flutterEngine?.dartExecutor?.binaryMessenger, CHANNEL)
                .invokeMethod("onNavBarVisibility", isNavBarVisible)
        }
    })
}

// 记得在onDestroy移除监听，避免内存泄漏
override fun onDestroy() {
    super.onDestroy()
    window.decorView.viewTreeObserver.removeOnGlobalLayoutListener(this)
}

Flutter 端监听与使用 #

bool _isNavBarVisible = true;

@override
void initState() {
    super.initState();
    _channel.setMethodCallHandler((call) {
        if (call.method == "onNavBarVisibility") {
            setState(() {
                _isNavBarVisible = call.arguments as bool;
            });
        }
        return Future.value(null);
    });
}

Future<bool> _handleWillPop() async {
    if (!_isNavBarVisible) {
        // 无导航栏，判定为侧滑返回
        _scaffoldKey.currentState?.openDrawer();
        return false;
    } else {
        // 有导航栏，判定为返回按键触发
        if (await _webViewController.canGoBack()) {
            _webViewController.goBack();
            return false;
        }
        return true;
    }
}

注意事项 #

• Android 10以下没有官方API获取导航模式，只能通过导航栏高度间接判断，可靠性略低；
• 确保MethodChannel的通道名称在原生和Flutter端完全一致；
• 监听布局变化时务必移除监听，避免内存泄漏。

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