Flutter身份验证插件flutter_robusta_auth的使用

flutter_robusta_auth 是一个用于 Flutter 应用的身份验证插件，通常用于处理用户登录、注册、注销等身份验证相关的功能。以下是如何使用 flutter_robusta_auth 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化插件

在你的 Flutter 应用中初始化 flutter_robusta_auth 插件。

import 'package:flutter_robusta_auth/flutter_robusta_auth.dart';

void main() {
  final authPlugin = AuthPlugin();

  runApp(
    RobustaApp(
      plugins: [authPlugin],
      child: MyApp(),
    ),
  );
}

3. 配置身份验证

你可以通过 AuthPlugin 配置身份验证的行为。例如，设置登录页面、注册页面等。

authPlugin.configure(
  loginBuilder: (context) => LoginPage(),
  registerBuilder: (context) => RegisterPage(),
);

4. 创建登录和注册页面

创建登录和注册页面。你可以使用 AuthPlugin 提供的 login 和 register 方法来处理用户登录和注册。

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

class LoginPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final auth = AuthPlugin.of(context);

    return Scaffold(
      appBar: AppBar(title: Text('Login')),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            final result = await auth.login();
            if (result) {
              Navigator.of(context).pushReplacementNamed('/home');
            } else {
              // 处理登录失败
            }
          },
          child: Text('Login'),
        ),
      ),
    );
  }
}

class RegisterPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final auth = AuthPlugin.of(context);

    return Scaffold(
      appBar: AppBar(title: Text('Register')),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            final result = await auth.register();
            if (result) {
              Navigator.of(context).pushReplacementNamed('/home');
            } else {
              // 处理注册失败
            }
          },
          child: Text('Register'),
        ),
      ),
    );
  }
}

5. 处理身份验证状态

你可以使用 AuthPlugin 来监听身份验证状态的变化，并根据状态更新 UI。

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

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final auth = AuthPlugin.of(context);

    return Scaffold(
      appBar: AppBar(title: Text('Home')),
      body: Center(
        child: StreamBuilder<AuthState>(
          stream: auth.authState,
          builder: (context, snapshot) {
            if (snapshot.data == AuthState.authenticated) {
              return Text('Welcome, User!');
            } else {
              return Text('Please login or register.');
            }
          },
        ),
      ),
    );
  }
}

6. 注销用户

你可以在用户点击注销按钮时调用 logout 方法。

ElevatedButton(
  onPressed: () async {
    await auth.logout();
    Navigator.of(context).pushReplacementNamed('/login');
  },
  child: Text('Logout'),
);

7. 保护路由

你可以使用 AuthGuard 来保护某些路由，确保只有已登录的用户才能访问。

import 'package:flutter_robusta_auth/flutter_robusta_auth.dart';

final authPlugin = AuthPlugin();

authPlugin.configure(
  loginBuilder: (context) => LoginPage(),
  registerBuilder: (context) => RegisterPage(),
);

final router = RouterPlugin();

router.configure(
  routes: [
    Route(
      path: '/home',
      builder: (context) => HomePage(),
      guards: [AuthGuard()],
    ),
  ],
);

void main() {
  runApp(
    RobustaApp(
      plugins: [authPlugin, router],
      child: MyApp(),
    ),
  );
}

8. 自定义身份验证逻辑

你可以通过继承 AuthProvider 来实现自定义的身份验证逻辑。

class CustomAuthProvider extends AuthProvider {
  [@override](/user/override)
  Future<bool> login() async {
    // 自定义登录逻辑
    return true;
  }

  [@override](/user/override)
  Future<bool> register() async {
    // 自定义注册逻辑
    return true;
  }

  [@override](/user/override)
  Future<void> logout() async {
    // 自定义注销逻辑
  }
}

void main() {
  final authPlugin = AuthProvider(CustomAuthProvider());

  runApp(
    RobustaApp(
      plugins: [authPlugin],
      child: MyApp(),
    ),
  );
}