package_custom_route_transitions 是一个用于 Flutter 的自定义路由过渡动画插件。它允许开发者轻松地为应用中的页面切换添加自定义的过渡动画。以下是使用该插件的基本步骤：

1. 添加依赖

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

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

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

2. 基本使用

你可以使用 CustomRouteTransition 来定义自定义的路由过渡动画。以下是一个简单的示例：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Custom Route Transitions Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.push(
              context,
              CustomRouteTransition(
                child: SecondPage(),
                transitionType: TransitionType.slideLeft,
                duration: Duration(milliseconds: 500),
              ),
            );
          },
          child: Text('Go to Second Page'),
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Second Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.pop(context);
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

3. 自定义过渡动画

CustomRouteTransition 提供了多种内置的过渡动画类型，例如 TransitionType.slideLeft、TransitionType.fade、TransitionType.scale 等。你可以通过 transitionType 参数来指定所需的过渡动画。

CustomRouteTransition(
  child: SecondPage(),
  transitionType: TransitionType.fade,  // 使用淡入淡出动画
  duration: Duration(milliseconds: 500),
),

4. 自定义动画

如果你想要更复杂的自定义动画，你可以使用 CustomRouteTransition.custom 构造函数，并提供一个自定义的 PageRouteBuilder。

Navigator.push(
  context,
  CustomRouteTransition.custom(
    child: SecondPage(),
    pageRouteBuilder: (context, animation, secondaryAnimation, child) {
      return SlideTransition(
        position: Tween<Offset>(
          begin: Offset(1.0, 0.0),
          end: Offset.zero,
        ).animate(CurvedAnimation(
          parent: animation,
          curve: Curves.easeInOut,
        )),
        child: child,
      );
    },
    duration: Duration(milliseconds: 500),
  ),
);

5. 其他配置

你可以通过 duration 参数来控制动画的持续时间，或者通过 opaque 和 barrierDismissible 参数来配置路由的其他行为。

CustomRouteTransition(
  child: SecondPage(),
  transitionType: TransitionType.slideLeft,
  duration: Duration(milliseconds: 1000),  // 动画持续1秒
  opaque: false,  // 路由是否不透明
  barrierDismissible: true,  // 是否可以通过点击背景来关闭路由
),