Flutter智能卡读写插件flutter_pcsc_windows的使用

Flutter智能卡读写插件flutter_pcsc_windows的使用

flutter_pcsc_windows 是 flutter_pcsc 插件在 Windows 平台上的实现。该插件允许 Flutter 应用程序在 Windows 上与智能卡进行交互。

使用

此包已被官方推荐使用（endorsed），这意味着你只需像平常一样使用 flutter_pcsc。当你这样做时，这个包会自动包含在你的应用中。

完整示例

以下是一个完整的示例，展示了如何使用 flutter_pcsc_windows 插件来读取智能卡的序列号。

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

import 'package:flutter_pcsc_platform_interface/flutter_pcsc_platform_interface.dart';

void main() {
  MyApp? myApp;

  runZonedGuarded(() async {
    PcscWindows.registerWith(); // 注册插件
    WidgetsFlutterBinding.ensureInitialized(); // 初始化绑定
    FlutterError.onError = (FlutterErrorDetails details) {
      FlutterError.dumpErrorToConsole(details); // 错误处理
      myApp?.addError(details.toString());
    };

    runApp(myApp = MyApp());
  }, (Object error, StackTrace stack) {
    print(error.toString()); // 打印错误信息
    myApp?.addError(error.toString());
  });
}

class MyApp extends StatelessWidget {
  final GlobalKey<_MyAppBodyState> _myAppKey = GlobalKey();

  MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
          appBar: AppBar(
            title: const Text('插件示例应用'),
          ),
          body: MyAppBody(key: _myAppKey)),
    );
  }

  void addError(String msg) {
    _myAppKey.currentState?.addMessage(Message.error(msg)); // 添加错误消息
  }
}

class MyAppBody extends StatefulWidget {
  const MyAppBody({required Key key}) : super(key: key);

  [@override](/user/override)
  _MyAppBodyState createState() {
    return _MyAppBodyState();
  }
}

enum MessageType { info, error, highlight }

class Message {
  final String content;
  final MessageType type;
  Message(this.type, this.content);

  static Message info(String content) {
    return Message(MessageType.info, content);
  }

  static Message highlight(String content) {
    return Message(MessageType.highlight, content);
  }

  static Message error(String content) {
    return Message(MessageType.error, content);
  }
}

class _MyAppBodyState extends State<MyAppBody> {
  static const List<int> getCardSerialNumberCommand = [
    0xFF, // CLA (指令类)
    0xCA, // INS (指令码)
    0x00, // P1 (参数1)
    0x00, // P2 (参数2)
    0x00  // Lc (数据长度)
  ];
  final ScrollController _scrollController = ScrollController();

  final List<Message> _messages = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    getCardSerialNumber();
  }

  void addMessage(Message m) {
    setState(() {
      _messages.add(m);
    });
  }

  Future<void> getCardSerialNumber() async {
    int ctx = await PcscPlatform.instance
        .establishContext(PcscConstants.CARD_SCOPE_USER); // 建立上下文
    Map<String, dynamic>? card;
    try {
      List<String> readers = await PcscPlatform.instance.listReaders(ctx); // 列出读卡器

      for (String reader in readers) {
        setState(() {
          _messages.add(Message.info('找到读卡器: $reader')); // 显示读卡器信息
        });
      }

      if (readers.isEmpty) {
        setState(() {
          _messages.add(Message.error('无法检测到任何读卡器')); // 如果没有读卡器则显示错误信息
        });
      } else {
        String reader = readers[0];
        setState(() {
          _messages.add(Message.highlight('使用读卡器: $reader')); // 选择第一个读卡器
        });

        card = await PcscPlatform.instance.cardConnect(ctx, reader,
            PcscConstants.SCARD_SHARE_SHARED, PcscConstants.SCARD_PROTOCOL_ANY); // 连接卡片
        var response = await PcscPlatform.instance.transmit(card!['h_card'],
            card['active_protocol'], getCardSerialNumberCommand); // 发送命令获取序列号
        var sw = response.sublist(response.length - 2); // 获取状态字节
        var sn = response.sublist(0, response.length - 2); // 获取序列号

        if (sw[0] != 0x90 || sw[1] != 0x00) {
          setState(() {
            _messages
                .add(Message.error('卡片返回错误: ${hexDump(sw)}')); // 如果有错误则显示错误信息
          });
        } else {
          setState(() {
            _messages
                .add(Message.info('卡片序列号为: ${hexDump(sn)}')); // 如果成功则显示序列号
            _messages.add(Message.info('完成'));
          });
        }
      }
    } finally {
      if (card != null) {
        try {
          await PcscPlatform.instance
              .cardDisconnect(card['h_card'], PcscConstants.SCARD_RESET_CARD); // 断开卡片连接
        } on Exception catch (e) {
          setState(() {
            _messages.add(Message.error(e.toString())); // 捕获异常并显示错误信息
          });
        }
      }
      try {
        await PcscPlatform.instance.releaseContext(ctx); // 释放上下文
      } on Exception catch (e) {
        setState(() {
          _messages.add(Message.error(e.toString())); // 捕获异常并显示错误信息
        });
      }
    }
  }

  static String hexDump(List<int> csn) {
    return csn
        .map((i) => i.toRadixString(16).padLeft(2, '0').toUpperCase()) // 转换为十六进制字符串
        .join(' ');
  }

  _scrollToBottom() {
    _scrollController.jumpTo(_scrollController.position.maxScrollExtent); // 滚动到底部
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    TextStyle errorStyle = const TextStyle(color: Colors.red);
    TextStyle highlightStyle = const TextStyle(color: Colors.green);
    WidgetsBinding.instance?.addPostFrameCallback((_) => _scrollToBottom());
    return Row(crossAxisAlignment: CrossAxisAlignment.start, children: [
      Expanded(
          child: Column(children: [
        Expanded(
            child: ListView(
                controller: _scrollController,
                children: _messages
                    .map((e) => Text(e.content,
                        style: e.type == MessageType.error
                            ? errorStyle
                            : e.type == MessageType.highlight
                                ? highlightStyle
                                : null))
                    .toList())), // 显示消息列表
        Container(
            margin: const EdgeInsets.all(10),
            child: ElevatedButton(
                onPressed: () async {
                  await tryAgain(); // 尝试重新读取
                },
                child: const Text("重试")))
      ]))
    ]);
  }

  tryAgain() async {
    setState(() {
      _messages.clear(); // 清空消息列表
    });
    await getCardSerialNumber(); // 重新获取序列号
  }
}