Flutter认证授权插件tots_auth的使用

tots_auth 是一个用于 Flutter 的认证和授权插件，它简化了用户认证和授权的流程。通过 tots_auth，你可以轻松地集成各种认证方式（如电子邮件/密码、社交媒体登录等）以及管理用户的授权。

安装

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

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

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

基本用法

1. 初始化

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

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 TotsAuth
  await TotsAuth.initialize(
    apiKey: 'YOUR_API_KEY',
    baseUrl: 'https://your-api-url.com',
  );

  runApp(MyApp());
}

2. 用户注册

你可以使用 TotsAuth 来注册新用户：

import 'package:tots_auth/tots_auth.dart';

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

3. 用户登录

用户登录可以通过以下方式实现：

import 'package:tots_auth/tots_auth.dart';

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

4. 检查用户是否已登录

你可以检查用户是否已经登录：

import 'package:tots_auth/tots_auth.dart';

Future<void> checkLoginStatus() async {
  final isLoggedIn = await TotsAuth.instance.isLoggedIn();
  if (isLoggedIn) {
    print('User is logged in');
  } else {
    print('User is not logged in');
  }
}

5. 获取当前用户信息

你可以获取当前登录用户的信息：

import 'package:tots_auth/tots_auth.dart';

Future<void> getCurrentUser() async {
  final user = await TotsAuth.instance.getCurrentUser();
  if (user != null) {
    print('Current user: ${user.email}');
  } else {
    print('No user is logged in');
  }
}

6. 用户注销

用户可以通过以下方式注销：

import 'package:tots_auth/tots_auth.dart';

Future<void> logoutUser() async {
  await TotsAuth.instance.logout();
  print('User logged out');
}

高级用法

1. 使用社交媒体登录

tots_auth 支持通过社交媒体（如 Google、Facebook 等）进行登录。你需要先配置相应的社交媒体登录 SDK，然后使用 TotsAuth 进行登录。

import 'package:tots_auth/tots_auth.dart';

Future<void> loginWithGoogle() async {
  try {
    final user = await TotsAuth.instance.loginWithGoogle();
    print('User logged in with Google: ${user.email}');
  } catch (e) {
    print('Google login failed: $e');
  }
}

2. 管理用户授权

tots_auth 还提供了用户授权的管理功能。你可以检查用户是否具有特定权限，或者为用户分配权限。

import 'package:tots_auth/tots_auth.dart';

Future<void> checkPermission() async {
  final hasPermission = await TotsAuth.instance.hasPermission('edit_profile');
  if (hasPermission) {
    print('User has permission to edit profile');
  } else {
    print('User does not have permission to edit profile');
  }
}

错误处理

在使用 tots_auth 时，可能会遇到各种错误（如网络错误、认证失败等）。你可以通过 try-catch 块来捕获并处理这些错误。

import 'package:tots_auth/tots_auth.dart';

Future<void> loginUser() async {
  try {
    final user = await TotsAuth.instance.login(
      email: 'user@example.com',
      password: 'password123',
    );
    print('User logged in: ${user.email}');
  } on TotsAuthException catch (e) {
    print('Authentication failed: ${e.message}');
  } catch (e) {
    print('An unexpected error occurred: $e');
  }
}