kit_2fa 是一个用于在 Flutter 应用中实现双重认证（2FA）的插件。它可以帮助你生成和验证基于时间的一次性密码（TOTP），这是许多双重认证系统（如 Google Authenticator）的核心功能。

以下是如何在 Flutter 项目中使用 kit_2fa 插件的步骤：

1. 添加依赖

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

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

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

2. 导入插件

在你的 Dart 文件中导入 kit_2fa 插件：

import 'package:kit_2fa/kit_2fa.dart';

3. 生成 TOTP

你可以使用 Kit2FA.generateTOTP 方法来生成基于时间的一次性密码。你需要提供一个密钥（通常是一个 Base32 编码的字符串）和一个时间戳。

String secretKey = "JBSWY3DPEHPK3PXP"; // 示例密钥
int timestamp = DateTime.now().millisecondsSinceEpoch ~/ 1000; // 当前时间戳

String totp = Kit2FA.generateTOTP(secretKey, timestamp);
print("Generated TOTP: $totp");

4. 验证 TOTP

你可以使用 Kit2FA.verifyTOTP 方法来验证用户输入的 TOTP 是否正确。

String userInput = "123456"; // 用户输入的 TOTP
bool isValid = Kit2FA.verifyTOTP(secretKey, userInput, timestamp);

if (isValid) {
  print("TOTP is valid!");
} else {
  print("TOTP is invalid!");
}

5. 处理密钥

通常，密钥是通过扫描二维码或手动输入的方式获取的。你可以使用 Kit2FA.generateSecretKey 方法来生成一个新的密钥：

String newSecretKey = Kit2FA.generateSecretKey();
print("New Secret Key: $newSecretKey");

6. 生成二维码

为了方便用户扫描密钥，你可以生成一个二维码。你可以使用 qr_flutter 插件来生成二维码：

dependencies:
  qr_flutter: ^4.0.0

然后生成二维码：

import 'package:qr_flutter/qr_flutter.dart';

QrImage(
  data: "otpauth://totp/YourApp:user@example.com?secret=$newSecretKey&issuer=YourApp",
  version: QrVersions.auto,
  size: 200.0,
);

7. 完整示例

以下是一个完整的示例，展示了如何生成和验证 TOTP：

import 'package:flutter/material.dart';
import 'package:kit_2fa/kit_2fa.dart';
import 'package:qr_flutter/qr_flutter.dart';

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

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

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

class _TwoFAPageState extends State<TwoFAPage> {
  String secretKey = Kit2FA.generateSecretKey();
  String totp = "";
  String userInput = "";
  bool isValid = false;

  void generateTOTP() {
    int timestamp = DateTime.now().millisecondsSinceEpoch ~/ 1000;
    setState(() {
      totp = Kit2FA.generateTOTP(secretKey, timestamp);
    });
  }

  void verifyTOTP() {
    int timestamp = DateTime.now().millisecondsSinceEpoch ~/ 1000;
    setState(() {
      isValid = Kit2FA.verifyTOTP(secretKey, userInput, timestamp);
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("2FA Example"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            QrImage(
              data: "otpauth://totp/YourApp:user@example.com?secret=$secretKey&issuer=YourApp",
              version: QrVersions.auto,
              size: 200.0,
            ),
            SizedBox(height: 20),
            Text("Secret Key: $secretKey"),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: generateTOTP,
              child: Text("Generate TOTP"),
            ),
            SizedBox(height: 20),
            Text("Generated TOTP: $totp"),
            SizedBox(height: 20),
            TextField(
              onChanged: (value) {
                setState(() {
                  userInput = value;
                });
              },
              decoration: InputDecoration(
                labelText: "Enter TOTP",
              ),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: verifyTOTP,
              child: Text("Verify TOTP"),
            ),
            SizedBox(height: 20),
            Text(isValid ? "TOTP is valid!" : "TOTP is invalid!"),
          ],
        ),
      ),
    );
  }
}