dart_board_authentication 是一个用于 Flutter 应用的身份验证插件，它提供了一种简单的方式来集成身份验证功能，支持多种身份验证方式，如电子邮件/密码、社交登录（Google、Facebook 等）等。以下是如何在 Flutter 项目中使用 dart_board_authentication 插件的步骤。

1. 添加依赖

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

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

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

2. 初始化插件

在你的 main.dart 文件中，初始化 dart_board_authentication 插件：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Auth Demo',
      home: AuthWrapper(),
    );
  }
}

class AuthWrapper extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return AuthFeature(
      child: HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: Text('Welcome!'),
      ),
    );
  }
}

3. 配置身份验证提供者

dart_board_authentication 支持多种身份验证提供者。你可以在 AuthFeature 中配置所需的提供者。例如，配置电子邮件/密码和 Google 登录：

import 'package:dart_board_authentication/dart_board_authentication.dart';

class AuthWrapper extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return AuthFeature(
      providers: [
        EmailAuthProvider(),
        GoogleAuthProvider(),
      ],
      child: HomeScreen(),
    );
  }
}

4. 使用身份验证功能

你可以在应用中使用 AuthFeature 提供的身份验证功能。例如，显示登录和注册按钮：

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                AuthFeature.of(context).signInWithEmail(
                  email: 'user@example.com',
                  password: 'password',
                );
              },
              child: Text('Sign In with Email'),
            ),
            ElevatedButton(
              onPressed: () {
                AuthFeature.of(context).signInWithGoogle();
              },
              child: Text('Sign In with Google'),
            ),
            ElevatedButton(
              onPressed: () {
                AuthFeature.of(context).signOut();
              },
              child: Text('Sign Out'),
            ),
          ],
        ),
      ),
    );
  }
}

5. 处理身份验证状态

你可以通过 AuthFeature.of(context).authState 来监听身份验证状态的变化，并根据状态更新 UI：

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: StreamBuilder<AuthState>(
          stream: AuthFeature.of(context).authState,
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.waiting) {
              return CircularProgressIndicator();
            } else if (snapshot.hasData && snapshot.data!.isSignedIn) {
              return Text('Welcome, ${snapshot.data!.user!.email}');
            } else {
              return Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  ElevatedButton(
                    onPressed: () {
                      AuthFeature.of(context).signInWithEmail(
                        email: 'user@example.com',
                        password: 'password',
                      );
                    },
                    child: Text('Sign In with Email'),
                  ),
                  ElevatedButton(
                    onPressed: () {
                      AuthFeature.of(context).signInWithGoogle();
                    },
                    child: Text('Sign In with Google'),
                  ),
                ],
              );
            }
          },
        ),
      ),
    );
  }
}

6. 自定义身份验证流程

你还可以通过继承 AuthProvider 类来实现自定义的身份验证提供者，并将其添加到 AuthFeature 的 providers 列表中。

7. 处理错误

在进行身份验证时，可能会遇到各种错误。你可以通过 try-catch 块来捕获并处理这些错误：

ElevatedButton(
  onPressed: () async {
    try {
      await AuthFeature.of(context).signInWithEmail(
        email: 'user@example.com',
        password: 'password',
      );
    } catch (e) {
      print('Failed to sign in: $e');
      // 显示错误消息给用户
    }
  },
  child: Text('Sign In with Email'),
);