unpub_auth 是一个用于 Flutter 应用的认证和授权插件，通常用于在应用中处理用户登录、注册、权限管理等操作。它可以帮助开发者快速集成认证和授权功能，而不需要从头开始实现这些功能。

安装

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

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

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

基本使用

1. 初始化插件

在使用 unpub_auth 之前，通常需要对其进行初始化。你可以在应用的 main.dart 文件中进行初始化：

import 'package:unpub_auth/unpub_auth.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 unpub_auth
  await UnpubAuth.initialize(
    authUrl: 'https://your-auth-server.com',
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    redirectUri: 'your-redirect-uri',
  );

  runApp(MyApp());
}

2. 用户登录

你可以使用 UnpubAuth 提供的 login 方法来处理用户登录：

Future<void> login() async {
  try {
    await UnpubAuth.login(
      username: 'user@example.com',
      password: 'password',
    );
    print('Login successful!');
  } catch (e) {
    print('Login failed: $e');
  }
}

3. 用户注册

unpub_auth 也提供了用户注册的功能：

Future<void> register() async {
  try {
    await UnpubAuth.register(
      email: 'user@example.com',
      password: 'password',
      username: 'username',
    );
    print('Registration successful!');
  } catch (e) {
    print('Registration failed: $e');
  }
}

4. 检查用户是否已登录

你可以使用 UnpubAuth.isLoggedIn 来检查用户是否已经登录：

bool isLoggedIn = await UnpubAuth.isLoggedIn();
if (isLoggedIn) {
  print('User is logged in');
} else {
  print('User is not logged in');
}

5. 获取用户信息

登录成功后，你可以通过 UnpubAuth.getUserInfo 获取用户信息：

Map<String, dynamic> userInfo = await UnpubAuth.getUserInfo();
print('User info: $userInfo');

6. 用户登出

用户登出可以通过 UnpubAuth.logout 方法来实现：

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

高级用法

1. 自定义授权流程

unpub_auth 也支持自定义授权流程，你可以使用 UnpubAuth.authorize 方法来处理 OAuth2 授权流程：

Future<void> authorize() async {
  final authResult = await UnpubAuth.authorize(
    scopes: ['read', 'write'],
  );
  print('Authorization result: $authResult');
}

2. 刷新 Token

如果你的应用需要长时间保持用户登录状态，你可能需要定期刷新 Token。unpub_auth 提供了 refreshToken 方法：

Future<void> refreshToken() async {
  try {
    await UnpubAuth.refreshToken();
    print('Token refreshed successfully');
  } catch (e) {
    print('Failed to refresh token: $e');
  }
}

注意事项

1. 安全性：确保你在生产环境中使用 HTTPS 来保护用户数据。
2. 错误处理：在实际应用中，建议对所有的 API 调用进行错误处理，以便在出现问题时能够给出友好的提示。
3. Token 管理：Token 是用户认证的关键，确保你的应用能够正确处理 Token 的存储和刷新。

示例应用

以下是一个简单的示例应用，展示了如何使用 unpub_auth 进行用户登录和登出：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await UnpubAuth.initialize(
    authUrl: 'https://your-auth-server.com',
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    redirectUri: 'your-redirect-uri',
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: AuthScreen(),
    );
  }
}

class AuthScreen extends StatefulWidget {
  [@override](/user/override)
  _AuthScreenState createState() => _AuthScreenState();
}

class _AuthScreenState extends State<AuthScreen> {
  bool _isLoggedIn = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    _checkLoginStatus();
  }

  Future<void> _checkLoginStatus() async {
    bool isLoggedIn = await UnpubAuth.isLoggedIn();
    setState(() {
      _isLoggedIn = isLoggedIn;
    });
  }

  Future<void> _login() async {
    try {
      await UnpubAuth.login(
        username: 'user@example.com',
        password: 'password',
      );
      setState(() {
        _isLoggedIn = true;
      });
    } catch (e) {
      print('Login failed: $e');
    }
  }

  Future<void> _logout() async {
    await UnpubAuth.logout();
    setState(() {
      _isLoggedIn = false;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Auth Demo'),
      ),
      body: Center(
        child: _isLoggedIn
            ? ElevatedButton(
                onPressed: _logout,
                child: Text('Logout'),
              )
            : ElevatedButton(
                onPressed: _login,
                child: Text('Login'),
              ),
      ),
    );
  }
}