lyon1casclient 是一个用于 Flutter 的插件，旨在帮助开发者与 Lyon 1 大学的 CAS (Central Authentication Service) 系统进行集成。CAS 是一种单点登录（SSO）协议，允许用户通过一次登录访问多个应用程序。通过 lyon1casclient 插件，Flutter 应用可以实现与 Lyon 1 大学 CAS 系统的无缝集成，从而允许用户使用他们的大学凭据进行身份验证。

主要功能

1. 用户身份验证：允许用户使用 Lyon 1 大学的 CAS 系统进行身份验证。
2. 获取用户信息：在身份验证成功后，可以获取用户的详细信息（如用户名、电子邮件等）。
3. 单点登录 (SSO)：支持 CAS 的单点登录功能，用户只需登录一次即可访问多个应用。
4. 注销功能：提供注销功能，允许用户从 CAS 系统中注销。

使用步骤

1. 添加依赖

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

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

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

2. 初始化 CAS 客户端

在你的 Flutter 应用中，初始化 lyon1casclient 插件：

import 'package:lyon1casclient/lyon1casclient.dart';

final casClient = Lyon1CasClient(
  casUrl: 'https://cas.univ-lyon1.fr/cas',  // Lyon 1 大学的 CAS URL
  serviceUrl: 'https://yourapp.com/callback',  // 你的应用的回调 URL
);

3. 用户登录

使用 casClient.login() 方法来启动用户登录流程。通常，这会在用户点击“登录”按钮时调用：

void login() async {
  try {
    final ticket = await casClient.login();
    print('登录成功，Ticket: $ticket');
    // 你可以使用 ticket 来获取用户信息或进行其他操作
  } catch (e) {
    print('登录失败: $e');
  }
}

4. 获取用户信息

在用户成功登录后，你可以使用 casClient.getUserInfo() 方法来获取用户的详细信息：

void getUserInfo() async {
  try {
    final userInfo = await casClient.getUserInfo();
    print('用户信息: $userInfo');
  } catch (e) {
    print('获取用户信息失败: $e');
  }
}

5. 用户注销

使用 casClient.logout() 方法来注销用户：

void logout() async {
  try {
    await casClient.logout();
    print('注销成功');
  } catch (e) {
    print('注销失败: $e');
  }
}

注意事项

• 回调 URL：确保你提供的 serviceUrl 是你的应用能够处理回调的 URL。通常，这是一个 HTTPS 地址。
• 错误处理：在实际应用中，建议对登录、获取用户信息、注销等操作进行详细的错误处理，以提供更好的用户体验。
• 安全性：确保你的应用在处理用户凭据和敏感信息时遵循最佳安全实践。

示例代码

以下是一个简单的 Flutter 应用示例，展示了如何使用 lyon1casclient 插件：

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

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

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

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

class _HomePageState extends State<HomePage> {
  final casClient = Lyon1CasClient(
    casUrl: 'https://cas.univ-lyon1.fr/cas',
    serviceUrl: 'https://yourapp.com/callback',
  );

  String userInfo = '未登录';

  void login() async {
    try {
      final ticket = await casClient.login();
      print('登录成功，Ticket: $ticket');
      await getUserInfo();
    } catch (e) {
      print('登录失败: $e');
    }
  }

  void getUserInfo() async {
    try {
      final info = await casClient.getUserInfo();
      setState(() {
        userInfo = info.toString();
      });
    } catch (e) {
      print('获取用户信息失败: $e');
    }
  }

  void logout() async {
    try {
      await casClient.logout();
      setState(() {
        userInfo = '未登录';
      });
      print('注销成功');
    } catch (e) {
      print('注销失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Lyon 1 CAS 示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('用户信息: $userInfo'),
            ElevatedButton(
              onPressed: login,
              child: Text('登录'),
            ),
            ElevatedButton(
              onPressed: logout,
              child: Text('注销'),
            ),
          ],
        ),
      ),
    );
  }
}