yubikit_flutter 是一个用于在 Flutter 应用中集成 YubiKey 安全认证的插件。YubiKey 是一种硬件安全密钥，支持多种认证协议，如 OTP、FIDO2、PIV 等。通过 yubikit_flutter 插件，开发者可以轻松地将 YubiKey 集成到 Flutter 应用中，以增强应用的安全性。

以下是如何使用 yubikit_flutter 插件的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  yubikit_flutter: ^1.0.0  # 请检查最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在需要使用 YubiKey 的 Dart 文件中导入插件：

import 'package:yubikit_flutter/yubikit_flutter.dart';

3. 初始化 YubiKit

在使用 YubiKey 之前，需要初始化 YubiKit：

void initYubiKit() async {
  await YubikitFlutter.initialize();
}

4. 检测 YubiKey

你可以通过以下代码检测是否连接了 YubiKey：

void checkYubiKey() async {
  bool isConnected = await YubikitFlutter.isYubiKeyConnected();
  if (isConnected) {
    print("YubiKey is connected.");
  } else {
    print("YubiKey is not connected.");
  }
}

5. 读取 YubiKey 信息

你可以读取 YubiKey 的基本信息，如序列号、版本等：

void readYubiKeyInfo() async {
  YubiKeyInfo? info = await YubikitFlutter.getYubiKeyInfo();
  if (info != null) {
    print("YubiKey Serial Number: ${info.serialNumber}");
    print("YubiKey Version: ${info.version}");
  } else {
    print("Failed to read YubiKey info.");
  }
}

6. 使用 YubiKey 进行认证

你可以使用 YubiKey 进行 OTP 或 FIDO2 认证。以下是一个简单的 OTP 认证示例：

void performOTPAuthentication() async {
  String otp = await YubikitFlutter.getOTP();
  if (otp != null) {
    print("OTP: $otp");
    // 在这里将 OTP 发送到服务器进行验证
  } else {
    print("Failed to get OTP.");
  }
}

7. 处理错误

在使用 YubiKey 时，可能会遇到各种错误，如未连接 YubiKey、操作超时等。你可以通过捕获异常来处理这些错误：

void performOperation() async {
  try {
    String otp = await YubikitFlutter.getOTP();
    print("OTP: $otp");
  } catch (e) {
    print("Error: $e");
  }
}

8. 释放资源

在应用退出或不再需要 YubiKey 时，释放相关资源：

void disposeYubiKit() async {
  await YubikitFlutter.dispose();
}

9. 完整示例

以下是一个完整的示例，展示了如何初始化 YubiKit、检测 YubiKey、读取信息并进行 OTP 认证：

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

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

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

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

class _YubiKeyExampleState extends State<YubiKeyExample> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initYubiKit();
  }

  void initYubiKit() async {
    await YubikitFlutter.initialize();
  }

  void checkYubiKey() async {
    bool isConnected = await YubikitFlutter.isYubiKeyConnected();
    if (isConnected) {
      print("YubiKey is connected.");
    } else {
      print("YubiKey is not connected.");
    }
  }

  void readYubiKeyInfo() async {
    YubiKeyInfo? info = await YubikitFlutter.getYubiKeyInfo();
    if (info != null) {
      print("YubiKey Serial Number: ${info.serialNumber}");
      print("YubiKey Version: ${info.version}");
    } else {
      print("Failed to read YubiKey info.");
    }
  }

  void performOTPAuthentication() async {
    try {
      String otp = await YubikitFlutter.getOTP();
      if (otp != null) {
        print("OTP: $otp");
        // 在这里将 OTP 发送到服务器进行验证
      } else {
        print("Failed to get OTP.");
      }
    } catch (e) {
      print("Error: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("YubiKey Example"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: checkYubiKey,
              child: Text("Check YubiKey"),
            ),
            ElevatedButton(
              onPressed: readYubiKeyInfo,
              child: Text("Read YubiKey Info"),
            ),
            ElevatedButton(
              onPressed: performOTPAuthentication,
              child: Text("Perform OTP Authentication"),
            ),
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    YubikitFlutter.dispose();
    super.dispose();
  }
}