awesome_toster 是一个用于在 Flutter 应用中显示简单、美观的 toast 提示的插件。它可以帮助你快速地在应用中显示短暂的提示信息，而不需要用户进行任何交互。以下是如何在 Flutter 项目中使用 awesome_toster 插件的步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 awesome_toster 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  awesome_toster: ^0.1.0  # 使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 awesome_toster 插件。

import 'package:awesome_toster/awesome_toster.dart';

3. 初始化 AwesomeToster

在使用 AwesomeToster 之前，你需要在应用的顶层组件中初始化它。通常，你可以在 MaterialApp 或 CupertinoApp 的 builder 方法中进行初始化。

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

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

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

4. 显示 Toast

现在你可以在任何地方使用 AwesomeToster.of(context) 来显示 toast 提示。

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Awesome Toster Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            AwesomeToster.of(context).showToast(
              message: 'This is a toast message!',
              toastType: ToastType.success, // 可以设置不同的类型：success, error, info, warning
            );
          },
          child: Text('Show Toast'),
        ),
      ),
    );
  }
}

5. 自定义 Toast

AwesomeToster 提供了多种自定义选项，例如设置 toast 的类型、持续时间、位置等。

AwesomeToster.of(context).showToast(
  message: 'Custom Toast',
  toastType: ToastType.error,
  duration: Duration(seconds: 3), // 设置持续时间
  position: ToastPosition.bottom, // 设置位置：top, center, bottom
);

6. 完整示例

以下是一个完整的示例代码：

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

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

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

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Awesome Toster Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                AwesomeToster.of(context).showToast(
                  message: 'Success Toast',
                  toastType: ToastType.success,
                );
              },
              child: Text('Show Success Toast'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                AwesomeToster.of(context).showToast(
                  message: 'Error Toast',
                  toastType: ToastType.error,
                );
              },
              child: Text('Show Error Toast'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                AwesomeToster.of(context).showToast(
                  message: 'Info Toast',
                  toastType: ToastType.info,
                );
              },
              child: Text('Show Info Toast'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                AwesomeToster.of(context).showToast(
                  message: 'Warning Toast',
                  toastType: ToastType.warning,
                );
              },
              child: Text('Show Warning Toast'),
            ),
          ],
        ),
      ),
    );
  }
}