auth3 是一个用于 Flutter 的身份验证插件，它提供了简单且强大的 API 来处理用户身份验证。以下是如何在 Flutter 项目中使用 auth3 插件的基本步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 auth3 插件的依赖：

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

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

2. 初始化 auth3

在你的 Flutter 应用中，你需要在 main.dart 或某个初始化文件中初始化 auth3。

import 'package:auth3/auth3.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 auth3
  await Auth3.initialize(
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',
  );

  runApp(MyApp());
}

3. 用户注册

使用 auth3 注册新用户：

void registerUser() async {
  try {
    final user = await Auth3.register(
      email: 'user@example.com',
      password: 'password123',
    );
    print('User registered: ${user.email}');
  } catch (e) {
    print('Registration failed: $e');
  }
}

4. 用户登录

使用 auth3 登录用户：

void loginUser() async {
  try {
    final user = await Auth3.login(
      email: 'user@example.com',
      password: 'password123',
    );
    print('User logged in: ${user.email}');
  } catch (e) {
    print('Login failed: $e');
  }
}

5. 用户登出

使用 auth3 登出当前用户：

void logoutUser() async {
  try {
    await Auth3.logout();
    print('User logged out');
  } catch (e) {
    print('Logout failed: $e');
  }
}

6. 获取当前用户

你可以通过 Auth3.currentUser 获取当前登录的用户：

void getCurrentUser() {
  final user = Auth3.currentUser;
  if (user != null) {
    print('Current user: ${user.email}');
  } else {
    print('No user is logged in');
  }
}

7. 监听用户状态变化

你可以监听用户身份验证状态的变化：

void listenToAuthState() {
  Auth3.onAuthStateChanged.listen((user) {
    if (user != null) {
      print('User is logged in: ${user.email}');
    } else {
      print('User is logged out');
    }
  });
}

8. 处理错误

在使用 auth3 时，可能会遇到各种错误。你可以通过 try-catch 块来捕获和处理这些错误。

void handleErrors() async {
  try {
    final user = await Auth3.login(
      email: 'user@example.com',
      password: 'wrongpassword',
    );
  } catch (e) {
    print('Error: $e');
  }
}

9. 其他功能

auth3 还提供了其他功能，如密码重置、邮箱验证等。你可以查阅官方文档以获取更多信息。

10. 示例应用

以下是一个简单的示例应用，展示了如何使用 auth3 进行用户注册、登录和登出：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Auth3.initialize(
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: AuthScreen(),
    );
  }
}

class AuthScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Auth3 Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: () async {
                try {
                  final user = await Auth3.register(
                    email: 'user@example.com',
                    password: 'password123',
                  );
                  print('User registered: ${user.email}');
                } catch (e) {
                  print('Registration failed: $e');
                }
              },
              child: Text('Register'),
            ),
            ElevatedButton(
              onPressed: () async {
                try {
                  final user = await Auth3.login(
                    email: 'user@example.com',
                    password: 'password123',
                  );
                  print('User logged in: ${user.email}');
                } catch (e) {
                  print('Login failed: $e');
                }
              },
              child: Text('Login'),
            ),
            ElevatedButton(
              onPressed: () async {
                try {
                  await Auth3.logout();
                  print('User logged out');
                } catch (e) {
                  print('Logout failed: $e');
                }
              },
              child: Text('Logout'),
            ),
          ],
        ),
      ),
    );
  }
}