Flutter阿里云盘认证插件aliyunpan_flutter_sdk_auth的使用

简介

aliyunpan_flutter_sdk_auth 是一个用于阿里云盘 OAuth 认证的 Flutter 插件。通过该插件，您可以轻松实现阿里云盘的登录认证功能。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 aliyunpan_flutter_sdk_auth 依赖：

dependencies:
  aliyunpan_flutter_sdk_auth: ^1.0.0

然后运行以下命令以安装依赖：

flutter pub get

2. 初始化插件

在项目的 main.dart 文件中初始化插件，并配置必要的参数。

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

void main() {
  runApp(MyApp());
}

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

class _MyAppState extends State<MyApp> {
  String _authUrl = ''; // 存储授权 URL
  bool _isAuthenticated = false; // 是否已认证

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化插件
    AliyunPanAuth.initialize(
      appId: 'your_app_id', // 替换为您的应用 ID
      appKey: 'your_app_key', // 替换为您的应用密钥
      redirectUri: 'your_redirect_uri', // 替换为您的回调 URI
    );
  }
}

3. 获取授权 URL

调用 AliyunPanAuth.getAuthorizationUrl() 方法获取授权 URL，并跳转到该 URL 进行用户登录。

Future<void> _getAuthUrl() async {
  try {
    _authUrl = await AliyunPanAuth.getAuthorizationUrl();
    print('授权 URL: $_authUrl');
    if (!mounted) return;
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => WebViewPage(url: _authUrl),
      ),
    );
  } catch (e) {
    print('获取授权 URL 失败: $e');
  }
}

4. 处理回调并获取令牌

在用户完成授权后，阿里云盘会将用户重定向到您配置的 redirectUri，并在 URL 中携带授权码。您需要解析授权码并请求访问令牌。

Future<void> _fetchAccessToken(String authCode) async {
  try {
    final accessToken = await AliyunPanAuth.getAccessToken(authCode);
    print('访问令牌: $accessToken');
    setState(() {
      _isAuthenticated = true; // 更新认证状态
    });
  } catch (e) {
    print('获取访问令牌失败: $e');
  }
}

5. 完整示例代码

以下是一个完整的示例代码，展示如何使用 aliyunpan_flutter_sdk_auth 实现阿里云盘的 OAuth 登录。

import 'package:flutter/material.dart';
import 'package:aliyunpan_flutter_sdk_auth/aliyunpan_flutter_sdk_auth.dart';
import 'package:url_launcher/url_launcher.dart';

void main() {
  runApp(MyApp());
}

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

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

class _AuthPageState extends State<AuthPage> {
  String _authUrl = '';
  bool _isAuthenticated = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    AliyunPanAuth.initialize(
      appId: 'your_app_id',
      appKey: 'your_app_key',
      redirectUri: 'your_redirect_uri',
    );
  }

  Future<void> _getAuthUrl() async {
    try {
      _authUrl = await AliyunPanAuth.getAuthorizationUrl();
      print('授权 URL: $_authUrl');
      launch(_authUrl); // 自动打开浏览器进行授权
    } catch (e) {
      print('获取授权 URL 失败: $e');
    }
  }

  Future<void> _fetchAccessToken(String authCode) async {
    try {
      final accessToken = await AliyunPanAuth.getAccessToken(authCode);
      print('访问令牌: $accessToken');
      setState(() {
        _isAuthenticated = true;
      });
    } catch (e) {
      print('获取访问令牌失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('阿里云盘 OAuth 登录'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _getAuthUrl,
              child: Text('开始授权'),
            ),
            SizedBox(height: 20),
            Visibility(
              visible: _isAuthenticated,
              child: Text('已成功认证！'),
            ),
          ],
        ),
      ),
    );
  }
}