flutter_robusta_hive_auth 是一个 Flutter 插件，用于结合 Robusta 路由管理和 Hive 本地存储来实现身份验证和数据存储的功能。它提供了一种简单的方式来管理用户的身份验证状态，并将用户数据存储在本地。

以下是如何使用 flutter_robusta_hive_auth 插件的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  robusta: ^latest_version
  hive: ^latest_version
  hive_flutter: ^latest_version
  flutter_robusta_hive_auth: ^latest_version

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

2. 初始化 Hive

在使用 Hive 之前，你需要初始化它。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  await Hive.initFlutter();
  runApp(MyApp());
}

3. 配置 Robusta 和 Hive Auth

接下来，你需要配置 Robusta 和 flutter_robusta_hive_auth 插件。你可以在 main.dart 文件中进行配置：

import 'package:flutter/material.dart';
import 'package:robusta/robusta.dart';
import 'package:flutter_robusta_hive_auth/flutter_robusta_hive_auth.dart';
import 'package:hive_flutter/hive_flutter.dart';

void main() async {
  await Hive.initFlutter();
  
  final authBox = await Hive.openBox('auth_box');
  
  final authExtension = HiveAuthExtension(authBox);
  
  final router = Router(
    extensions: [
      authExtension,
    ],
  );

  runApp(MyApp(router: router));
}

class MyApp extends StatelessWidget {
  final Router router;

  const MyApp({Key? key, required this.router}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routeInformationParser: router.routeInformationParser,
      routerDelegate: router.routerDelegate,
    );
  }
}

4. 使用 HiveAuthExtension 进行身份验证

HiveAuthExtension 提供了用于管理用户身份验证状态的方法。你可以在应用程序中使用这些方法来处理登录、注销等操作。

例如，处理用户登录：

import 'package:flutter/material.dart';
import 'package:robusta/robusta.dart';
import 'package:flutter_robusta_hive_auth/flutter_robusta_hive_auth.dart';

class LoginPage extends StatelessWidget {
  final HiveAuthExtension authExtension;

  const LoginPage({Key? key, required this.authExtension}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Login'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 模拟用户登录
            await authExtension.login('user_token');
            // 导航到主页
            context.go('/home');
          },
          child: Text('Login'),
        ),
      ),
    );
  }
}

处理用户注销：

import 'package:flutter/material.dart';
import 'package:robusta/robusta.dart';
import 'package:flutter_robusta_hive_auth/flutter_robusta_hive_auth.dart';

class HomePage extends StatelessWidget {
  final HiveAuthExtension authExtension;

  const HomePage({Key? key, required this.authExtension}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 用户注销
            await authExtension.logout();
            // 导航到登录页
            context.go('/login');
          },
          child: Text('Logout'),
        ),
      ),
    );
  }
}

5. 保护路由

你可以使用 HiveAuthExtension 来保护某些路由，只有在用户登录后才能访问。例如：

import 'package:robusta/robusta.dart';
import 'package:flutter_robusta_hive_auth/flutter_robusta_hive_auth.dart';

final router = Router(
  extensions: [
    HiveAuthExtension(authBox),
  ],
  routes: [
    Route(
      path: '/home',
      builder: (context) => HomePage(authExtension: context.read<HiveAuthExtension>()),
      guards: [
        AuthGuard(),
      ],
    ),
  ],
);

6. 读取用户数据

你可以从 Hive 中读取用户的身份验证数据：

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

class ProfilePage extends StatelessWidget {
  final HiveAuthExtension authExtension;

  const ProfilePage({Key? key, required this.authExtension}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    final userToken = authExtension.getToken();

    return Scaffold(
      appBar: AppBar(
        title: Text('Profile'),
      ),
      body: Center(
        child: Text('User Token: $userToken'),
      ),
    );
  }
}