fteam_authentication_core 是一个用于 Flutter 的认证核心插件，旨在简化用户认证流程，支持多种认证方式，如电子邮件/密码、社交媒体登录（如 Google、Facebook、Apple 等）以及 OAuth 认证。以下是该插件的基本使用方法和核心功能。

1. 安装插件

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

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

然后运行 flutter pub get 来安装插件。

2. 初始化插件

在使用插件之前，你需要在应用的入口处初始化插件。通常在 main.dart 文件中进行初始化：

import 'package:fteam_authentication_core/fteam_authentication_core.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化认证插件
  await FTeamAuthenticationCore.initialize(
    config: AuthenticationConfig(
      // 配置你的认证提供商，例如 Firebase、Google Sign-In 等
      providers: [
        EmailAuthProvider(),
        GoogleAuthProvider(),
        FacebookAuthProvider(),
        AppleAuthProvider(),
      ],
      // 其他配置项
    ),
  );

  runApp(MyApp());
}

3. 用户认证

fteam_authentication_core 提供了多种认证方式，以下是常见的认证操作：

3.1 电子邮件/密码认证

// 用户注册
final user = await FTeamAuthenticationCore.signUpWithEmail(
  email: 'user@example.com',
  password: 'password123',
);

// 用户登录
final user = await FTeamAuthenticationCore.signInWithEmail(
  email: 'user@example.com',
  password: 'password123',
);

3.2 社交媒体登录

// Google 登录
final user = await FTeamAuthenticationCore.signInWithGoogle();

// Facebook 登录
final user = await FTeamAuthenticationCore.signInWithFacebook();

// Apple 登录
final user = await FTeamAuthenticationCore.signInWithApple();

3.3 退出登录

await FTeamAuthenticationCore.signOut();

4. 监听认证状态

你可以监听用户的认证状态，以便在用户登录或退出时更新 UI：

FTeamAuthenticationCore.authStateChanges().listen((user) {
  if (user != null) {
    // 用户已登录
  } else {
    // 用户已退出
  }
});

5. 获取当前用户

你可以获取当前登录的用户信息：

final currentUser = FTeamAuthenticationCore.currentUser;
if (currentUser != null) {
  print('User ID: ${currentUser.uid}');
  print('Email: ${currentUser.email}');
}

6. 错误处理

在进行认证操作时，可能会遇到错误，建议使用 try-catch 块来处理异常：

try {
  final user = await FTeamAuthenticationCore.signInWithEmail(
    email: 'user@example.com',
    password: 'wrongpassword',
  );
} on AuthenticationException catch (e) {
  print('Authentication failed: ${e.message}');
}

7. 其他功能

fteam_authentication_core 还支持其他功能，如：

• 密码重置：通过电子邮件重置用户密码。
• 用户信息更新：更新用户的电子邮件、密码等信息。
• 多因素认证：支持多因素认证（MFA）。

8. 示例代码

以下是一个简单的 Flutter 应用示例，展示如何使用 fteam_authentication_core 进行用户认证：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FTeamAuthenticationCore.initialize(
    config: AuthenticationConfig(
      providers: [
        EmailAuthProvider(),
        GoogleAuthProvider(),
      ],
    ),
  );
  runApp(AuthApp());
}

class AuthApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Authentication Example')),
        body: AuthScreen(),
      ),
    );
  }
}

class AuthScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          ElevatedButton(
            onPressed: () async {
              try {
                final user = await FTeamAuthenticationCore.signInWithGoogle();
                print('User signed in: ${user.email}');
              } on AuthenticationException catch (e) {
                print('Error: ${e.message}');
              }
            },
            child: Text('Sign in with Google'),
          ),
          ElevatedButton(
            onPressed: () async {
              await FTeamAuthenticationCore.signOut();
              print('User signed out');
            },
            child: Text('Sign out'),
          ),
        ],
      ),
    );
  }
}