Flutter插件nacl_win的使用指南

nacl_win

nacl_win 是一个用于 Windows 的 Flutter 插件，用于生成 Ed25519 密钥对并签名消息。它使用了 Rust 编写的代码，并通过生成的 .dll 文件实现功能。flutter_rust_bridge 插件用于连接 Rust 和 Dart 代码。

可用方法：

• generateKey()
  生成一个 EdKeyPair 结构体，其中包含 Base64 格式的公钥和私钥。

• signMessage(String message, String key)
  使用指定的 Ed25519 密钥对消息进行签名。

异常处理：

• 如果 Sodium 库初始化失败，插件会抛出 InitializationFailedException。这种异常通常与 Rust 依赖项有关，可能与插件本身无关。

• 如果传递给 signMessage 方法的密钥无效（例如长度不足或不是 Base64 格式），插件将抛出 KeyDecodingFailedException，因为 Rust 无法将密钥从 Base64 转换为向量。

• 即使密钥解码成功，但如果 Rust 无法将密钥从向量转换为 Sodium 的 SecretKey，插件将抛出 KeyTransformingFailedException。

使用示例

以下是一个完整的示例代码，展示了如何使用 nacl_win 插件生成密钥并对消息进行签名。

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

import 'package:nacl_win/nacl_win.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String signature = 'Unknown'; // 存储签名结果

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState(); // 初始化平台状态
  }

  // 异步初始化平台状态
  Future<void> initPlatformState() async {
    String sig;
    try {
      // 生成密钥对
      var key = await NaclWin.generateKey();
      // 对消息进行签名
      sig = await NaclWin.signMessage('message', key.privKey);
      setState(() {
        signature = sig; // 更新签名结果
      });
    } catch (e) {
      print('Error: $e'); // 捕获并打印异常
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('NAcl Win 插件示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
            Text('签名结果: $signature\n'), // 显示签名结果
          ],
        ),
      ),
    );
  }
}