flutter_webauthn_wallet 是一个用于在 Flutter 应用中集成 WebAuthn 功能的插件，主要用于管理基于 WebAuthn 的钱包。WebAuthn 是一种基于公钥加密的认证协议，允许用户使用生物识别、硬件安全密钥等进行身份验证，而无需使用传统的密码。

安装插件

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

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

然后，运行 flutter pub get 来安装插件。

基本用法

1. 初始化插件

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

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterWebauthnWallet.initialize();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'WebAuthn Wallet Demo',
      home: WebAuthnWalletScreen(),
    );
  }
}

2. 创建 WebAuthn 凭证

在用户注册或添加新的凭证时，你可以使用 createCredential 方法来创建一个新的 WebAuthn 凭证。

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

class WebAuthnWalletScreen extends StatefulWidget {
  @override
  _WebAuthnWalletScreenState createState() => _WebAuthnWalletScreenState();
}

class _WebAuthnWalletScreenState extends State<WebAuthnWalletScreen> {
  Future<void> _createCredential() async {
    try {
      final credential = await FlutterWebauthnWallet.createCredential(
        challenge: 'random_challenge',
        rp: PublicKeyCredentialRpEntity(
          id: 'example.com',
          name: 'Example',
        ),
        user: PublicKeyCredentialUserEntity(
          id: 'user_id',
          name: 'user@example.com',
          displayName: 'User',
        ),
        pubKeyCredParams: [
          PublicKeyCredentialParameters(
            type: 'public-key',
            alg: -7, // ES256
          ),
        ],
        authenticatorSelection: AuthenticatorSelectionCriteria(
          authenticatorAttachment: 'platform',
          requireResidentKey: true,
          userVerification: 'preferred',
        ),
      );
      print('Credential created: $credential');
    } catch (e) {
      print('Failed to create credential: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('WebAuthn Wallet'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _createCredential,
          child: Text('Create Credential'),
        ),
      ),
    );
  }
}

3. 验证 WebAuthn 凭证

在用户登录时，你可以使用 getCredential 方法来验证用户的 WebAuthn 凭证。

Future<void> _getCredential() async {
  try {
    final assertion = await FlutterWebauthnWallet.getCredential(
      challenge: 'random_challenge',
      rpId: 'example.com',
      allowCredentials: [], // 允许的凭证列表
      userVerification: 'preferred',
    );
    print('Assertion received: $assertion');
  } catch (e) {
    print('Failed to get credential: $e');
  }
}

4. 管理凭证

你还可以使用插件提供的其他方法来管理用户的 WebAuthn 凭证，例如删除凭证、列出所有凭证等。

Future<void> _deleteCredential(String credentialId) async {
  try {
    await FlutterWebauthnWallet.deleteCredential(credentialId);
    print('Credential deleted: $credentialId');
  } catch (e) {
    print('Failed to delete credential: $e');
  }
}

Future<void> _listCredentials() async {
  try {
    final credentials = await FlutterWebauthnWallet.listCredentials();
    print('Credentials: $credentials');
  } catch (e) {
    print('Failed to list credentials: $e');
  }
}