routemaster_conductor 是一个用于 Flutter 的路由管理插件，它基于 routemaster 库，提供了更简单和直观的方式来管理应用的路由和导航。routemaster 本身是一个强大的路由库，支持声明式路由、嵌套路由、参数传递等功能，而 routemaster_conductor 则进一步简化了这些功能的使用。

安装

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

dependencies:
  flutter:
    sdk: flutter
  routemaster: ^1.0.0
  routemaster_conductor: ^1.0.0

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

基本使用

1. 定义路由

首先，你需要定义应用的路由。routemaster 使用 RouteMap 来定义路由表。

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

final routes = RouteMap(
  routes: {
    '/': (_) => MaterialPage(child: HomePage()),
    '/details': (_) => MaterialPage(child: DetailsPage()),
  },
);

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Home')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Routemaster.of(context).push('/details');
          },
          child: Text('Go to Details'),
        ),
      ),
    );
  }
}

class DetailsPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Details')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Routemaster.of(context).pop();
          },
          child: Text('Go back'),
        ),
      ),
    );
  }
}

2. 使用 routemaster_conductor

routemaster_conductor 提供了一个 Conductor 类，它可以帮助你更简单地管理路由。

import 'package:flutter/material.dart';
import 'package:routemaster/routemaster.dart';
import 'package:routemaster_conductor/routemaster_conductor.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routerDelegate: RoutemasterDelegate(
        routesBuilder: (context) => routes,
      ),
      routeInformationParser: RoutemasterParser(),
      builder: (context, child) {
        return Conductor(
          child: child!,
        );
      },
    );
  }
}

3. 导航

你可以使用 Routemaster.of(context) 来进行导航：

Routemaster.of(context).push('/details');

或者使用 Conductor 提供的 navigate 方法：

Conductor.of(context).navigate('/details');

高级功能

嵌套路由

routemaster 支持嵌套路由，你可以在 RouteMap 中定义嵌套路由：

final routes = RouteMap(
  routes: {
    '/': (_) => MaterialPage(child: HomePage()),
    '/profile': (_) => MaterialPage(child: ProfilePage()),
    '/profile/settings': (_) => MaterialPage(child: SettingsPage()),
  },
);

参数传递

你可以通过路由传递参数：

Routemaster.of(context).push('/details?id=123');

然后在目标页面中获取参数：

class DetailsPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final id = Routemaster.of(context).currentRoute.queryParameters['id'];
    return Scaffold(
      appBar: AppBar(title: Text('Details $id')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Routemaster.of(context).pop();
          },
          child: Text('Go back'),
        ),
      ),
    );
  }
}