sw_auth 是一个用于 Flutter 的认证管理插件，它简化了应用程序中用户认证流程的实现。这个插件通常用于处理用户登录、注册、密码重置等常见的认证功能。以下是如何在 Flutter 项目中使用 sw_auth 插件的基本指南。

1. 安装 sw_auth 插件

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

dependencies:
  flutter:
    sdk: flutter
  sw_auth: ^1.0.0  # 请使用最新的版本号

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

2. 初始化 sw_auth

在你的 main.dart 文件中，初始化 sw_auth 插件。通常，你需要在应用程序启动时配置认证相关的设置。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 sw_auth
  await SwAuth.initialize(
    baseUrl: 'https://your-api-endpoint.com',  // 替换为你的API端点
    tokenStorage: LocalTokenStorage(),         // 使用本地存储来保存token
  );

  runApp(MyApp());
}

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

3. 使用 sw_auth 进行用户认证

sw_auth 提供了多种方法来处理用户认证。以下是一些常见的用例：

用户登录

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

class LoginPage extends StatelessWidget {
  final _emailController = TextEditingController();
  final _passwordController = TextEditingController();

  Future<void> _login() async {
    try {
      await SwAuth.instance.login(
        email: _emailController.text,
        password: _passwordController.text,
      );
      // 登录成功后的操作，例如导航到主页
    } catch (e) {
      // 处理登录失败
      print('Login failed: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Login')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _emailController,
              decoration: InputDecoration(labelText: 'Email'),
            ),
            TextField(
              controller: _passwordController,
              decoration: InputDecoration(labelText: 'Password'),
              obscureText: true,
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _login,
              child: Text('Login'),
            ),
          ],
        ),
      ),
    );
  }
}

用户注册

Future<void> _register() async {
  try {
    await SwAuth.instance.register(
      email: _emailController.text,
      password: _passwordController.text,
    );
    // 注册成功后的操作
  } catch (e) {
    // 处理注册失败
    print('Registration failed: $e');
  }
}

密码重置

Future<void> _resetPassword() async {
  try {
    await SwAuth.instance.resetPassword(
      email: _emailController.text,
    );
    // 密码重置请求成功后的操作
  } catch (e) {
    // 处理密码重置失败
    print('Password reset failed: $e');
  }
}

检查用户是否已登录

bool isLoggedIn = await SwAuth.instance.isLoggedIn();
if (isLoggedIn) {
  // 用户已登录
} else {
  // 用户未登录
}

退出登录

await SwAuth.instance.logout();
// 退出登录后的操作

4. 处理认证状态

你可以使用 SwAuth 提供的 authStateStream 来监听用户的认证状态变化，并根据状态更新 UI。

class AuthWrapper extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return StreamBuilder<AuthState>(
      stream: SwAuth.instance.authStateStream,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return CircularProgressIndicator();
        }

        final authState = snapshot.data;
        if (authState == AuthState.authenticated) {
          return HomePage();
        } else {
          return LoginPage();
        }
      },
    );
  }
}

5. 高级配置

sw_auth 还支持更多高级配置，例如自定义 HTTP 客户端、Token 存储方式、错误处理等。你可以根据项目的需求进行配置。

await SwAuth.initialize(
  baseUrl: 'https://your-api-endpoint.com',
  tokenStorage: SecureTokenStorage(),  // 使用安全存储来保存token
  httpClient: MyCustomHttpClient(),    // 自定义HTTP客户端
);

6. 处理错误

sw_auth 会抛出自定义的异常，你可以捕获这些异常并处理它们。

try {
  await SwAuth.instance.login(
    email: _emailController.text,
    password: _passwordController.text,
  );
} on AuthException catch (e) {
  print('Auth error: ${e.message}');
} catch (e) {
  print('Unexpected error: $e');
}