ags_authrest 是一个用于 Flutter 的认证与授权插件，主要用于与 RESTful API 进行交互，处理用户认证和授权相关的功能。它通常用于需要用户登录、注册、获取访问令牌等场景。以下是如何使用 ags_authrest 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化插件

在你的 Flutter 应用中初始化 ags_authrest 插件。通常你可以在 main.dart 文件中进行初始化：

import 'package:ags_authrest/ags_authrest.dart';

void main() {
  // 初始化插件
  AgsAuthRest.initialize(
    baseUrl: 'https://your-api-endpoint.com', // 你的API基础URL
    tokenStorage: SecureTokenStorage(), // 使用安全存储来保存令牌
  );

  runApp(MyApp());
}

3. 用户登录

使用 ags_authrest 进行用户登录的示例：

import 'package:ags_authrest/ags_authrest.dart';

Future<void> login(String username, String password) async {
  try {
    final response = await AgsAuthRest.instance.login(
      username: username,
      password: password,
    );

    if (response.success) {
      print('登录成功，访问令牌: ${response.token}');
    } else {
      print('登录失败: ${response.message}');
    }
  } catch (e) {
    print('登录过程中发生错误: $e');
  }
}

4. 用户注册

使用 ags_authrest 进行用户注册的示例：

import 'package:ags_authrest/ags_authrest.dart';

Future<void> register(String username, String password, String email) async {
  try {
    final response = await AgsAuthRest.instance.register(
      username: username,
      password: password,
      email: email,
    );

    if (response.success) {
      print('注册成功');
    } else {
      print('注册失败: ${response.message}');
    }
  } catch (e) {
    print('注册过程中发生错误: $e');
  }
}

5. 获取用户信息

在用户登录后，你可以使用 ags_authrest 获取用户信息：

import 'package:ags_authrest/ags_authrest.dart';

Future<void> getUserInfo() async {
  try {
    final response = await AgsAuthRest.instance.getUserInfo();

    if (response.success) {
      print('用户信息: ${response.data}');
    } else {
      print('获取用户信息失败: ${response.message}');
    }
  } catch (e) {
    print('获取用户信息过程中发生错误: $e');
  }
}

6. 刷新访问令牌

如果访问令牌过期，你可以使用 ags_authrest 刷新令牌：

import 'package:ags_authrest/ags_authrest.dart';

Future<void> refreshToken() async {
  try {
    final response = await AgsAuthRest.instance.refreshToken();

    if (response.success) {
      print('令牌刷新成功，新令牌: ${response.token}');
    } else {
      print('令牌刷新失败: ${response.message}');
    }
  } catch (e) {
    print('令牌刷新过程中发生错误: $e');
  }
}

7. 用户注销

使用 ags_authrest 进行用户注销的示例：

import 'package:ags_authrest/ags_authrest.dart';

Future<void> logout() async {
  try {
    final response = await AgsAuthRest.instance.logout();

    if (response.success) {
      print('注销成功');
    } else {
      print('注销失败: ${response.message}');
    }
  } catch (e) {
    print('注销过程中发生错误: $e');
  }
}

8. 处理令牌存储

ags_authrest 提供了 TokenStorage 接口来处理令牌的存储。你可以使用 SecureTokenStorage 来安全地存储令牌，或者实现自己的 TokenStorage。

import 'package:ags_authrest/ags_authrest.dart';

class CustomTokenStorage implements TokenStorage {
  [@override](/user/override)
  Future<void> saveToken(String token) async {
    // 自定义存储逻辑
  }

  [@override](/user/override)
  Future<String?> getToken() async {
    // 自定义获取逻辑
    return null;
  }

  [@override](/user/override)
  Future<void> deleteToken() async {
    // 自定义删除逻辑
  }
}