nd_coordinators 是一个用于 Flutter 的协调器管理插件，它帮助开发者更好地管理页面导航和状态。通过使用协调器（Coordinator），你可以将页面导航逻辑从 UI 层分离出来，使得代码更加清晰和易于维护。

安装 nd_coordinators

首先，你需要在 pubspec.yaml 文件中添加 nd_coordinators 依赖：

dependencies:
  flutter:
    sdk: flutter
  nd_coordinators: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本使用

1. 创建协调器

协调器是管理页面导航的核心。你可以通过继承 Coordinator 类来创建自定义的协调器。

import 'package:nd_coordinators/nd_coordinators.dart';

class MyCoordinator extends Coordinator {
  MyCoordinator(BuildContext context) : super(context);

  void navigateToNextPage() {
    Navigator.push(
      context,
      MaterialPageRoute(builder: (context) => NextPage()),
    );
  }

  void goBack() {
    Navigator.pop(context);
  }
}

2. 在页面中使用协调器

在页面中，你可以通过 CoordinatorProvider 来提供协调器，并在需要的地方使用它。

import 'package:flutter/material.dart';
import 'package:nd_coordinators/nd_coordinators.dart';

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return CoordinatorProvider(
      create: (context) => MyCoordinator(context),
      child: Scaffold(
        appBar: AppBar(
          title: Text('Home Page'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text('Welcome to the Home Page!'),
              ElevatedButton(
                onPressed: () {
                  final coordinator = CoordinatorProvider.of<MyCoordinator>(context);
                  coordinator.navigateToNextPage();
                },
                child: Text('Go to Next Page'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

class NextPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Next Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            final coordinator = CoordinatorProvider.of<MyCoordinator>(context);
            coordinator.goBack();
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

3. 启动应用

在 main.dart 中启动应用：

import 'package:flutter/material.dart';
import 'my_home_page.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

高级用法

1. 多个协调器

你可以在不同的页面中使用不同的协调器，或者在一个页面中使用多个协调器来管理不同的导航逻辑。

class AnotherCoordinator extends Coordinator {
  AnotherCoordinator(BuildContext context) : super(context);

  void navigateToAnotherPage() {
    Navigator.push(
      context,
      MaterialPageRoute(builder: (context) => AnotherPage()),
    );
  }
}

在页面中使用多个协调器：

CoordinatorProvider(
  create: (context) => MyCoordinator(context),
  child: CoordinatorProvider(
    create: (context) => AnotherCoordinator(context),
    child: Scaffold(
      // ...
    ),
  ),
);

2. 协调器生命周期

协调器可以监听页面的生命周期事件，例如 initState 和 dispose。你可以在协调器中重写这些方法来执行相应的操作。

class MyCoordinator extends Coordinator {
  MyCoordinator(BuildContext context) : super(context);

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化操作
  }

  [@override](/user/override)
  void dispose() {
    // 清理操作
    super.dispose();
  }
}