如何在Flutter应用的所有页面中运行一段代码？

问题梳理 #

你需要在Flutter应用的所有页面中执行一段代码，同时实现Android层USB连接Intent触发时显示弹窗的功能。但直接在MyApp的initState里调用showDialog会报错：

Unhandled Exception: No MaterialLocalizations found.
MyApp widgets require MaterialLocalizations to be provided by a Localizations widget ancestor.

这是因为initState执行时，Widget树还未完全初始化，MaterialLocalizations这类依赖还未挂载，导致弹窗无法正常渲染。

可行解决方案 #

1. 用全局导航键实现任意位置弹窗/执行代码 #

通过全局NavigatorState键，能在应用任何地方获取当前上下文，轻松触发弹窗或执行全局逻辑。

步骤：

• 定义全局导航键：

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

• 在MaterialApp中配置这个键：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      home: const HomePage(),
    );
  }
}

• 处理Android MethodChannel回调时，用全局键获取上下文执行操作：

void _setupUsbChannel() {
  const usbChannel = MethodChannel('com.example/usb_connection');
  usbChannel.setMethodCallHandler((call) async {
    if (call.method == 'onUsbDeviceConnected') {
      final currentContext = navigatorKey.currentContext;
      if (currentContext != null) {
        showDialog(
          context: currentContext,
          builder: (_) => AlertDialog(
            title: const Text('USB设备已连接'),
            content: const Text('检测到USB设备，是否进行后续操作？'),
            actions: [
              TextButton(
                onPressed: () => Navigator.pop(currentContext),
                child: const Text('取消'),
              ),
              TextButton(
                onPressed: () {
                  // 这里写你的业务逻辑
                  Navigator.pop(currentContext);
                },
                child: const Text('确认'),
              ),
            ],
          ),
        );
      }
    }
  });
}

可以在MyApp的build方法里调用_setupUsbChannel()，确保应用启动时就完成通道初始化。

2. 监听路由变化实现页面级全局代码执行 #

如果需要每个页面加载时都执行一段代码，用RouteObserver监听路由切换是个好办法。

步骤：

• 定义全局路由观察者：

final RouteObserver<PageRoute> routeObserver = RouteObserver<PageRoute>();

• 在MaterialApp中添加观察者：

MaterialApp(
  navigatorObservers: [routeObserver],
  // 其他配置项
)

• 在页面中混入RouteAware，监听路由进入事件：

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

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> with RouteAware {
  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    routeObserver.subscribe(this, ModalRoute.of(context)!);
  }

  @override
  void dispose() {
    routeObserver.unsubscribe(this);
    super.dispose();
  }

  @override
  void didPush() {
    // 页面进入时执行全局代码
    _executeGlobalCode();
  }

  void _executeGlobalCode() {
    print('当前页面加载完成，执行全局逻辑');
    // 这里写你的全局代码
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('首页')),
    );
  }
}

所有混入RouteAware的页面，都会在进入时执行didPush里的代码。

3. 状态管理库实现全局状态驱动的代码执行 #

如果需要在全局状态变化时触发代码，比如用户登录状态改变，用Provider、Riverpod这类状态管理库，在状态更新时通知所有页面执行相应逻辑。

关键注意点 #

• 绝对不要在initState里直接调用依赖上下文的操作（比如showDialog），哪怕用addPostFrameCallback延迟执行，也不如全局导航键可靠。
• 处理Android Intent时，确保MethodChannel的初始化在应用启动阶段完成，避免回调触发时通道未初始化。

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