flutter_smart_card #

A Flutter plugin for communicating with smart card readers via USB. Supports Android, macOS, and Windows with platform-specific native implementations.

Features #

List readers - Discover connected smart card readers
Connect/Disconnect - Establish and close sessions with smart cards
Transmit APDU - Send and receive raw APDU commands

Platform Support #

Platform	Implementation	Notes
Android	USB Host (CCID)	Direct USB communication, requires USB host support
macOS	CryptoTokenKit	Uses system smart card framework
Windows	WinSCard	Uses Windows Smart Card API

Installation #

Add to your pubspec.yaml:

dependencies:
  flutter_smart_card: ^0.1.0

Platform Setup #

Android #

Add USB host feature to your AndroidManifest.xml:

<uses-feature android:name="android.hardware.usb.host" android:required="true" />

The plugin handles USB permission requests automatically.

Minimum SDK: 26 (Android 8.0)

macOS #

Add the following entitlement to your macos/Runner/DebugProfile.entitlements and macos/Runner/Release.entitlements:

<key>com.apple.security.smartcard</key>
<true/>

Windows #

No additional setup required. The plugin uses the WinSCard API which is available on all Windows versions.

Usage #

Basic Smart Card Communication #

import 'package:flutter_smart_card/flutter_smart_card.dart';

final smartCard = FlutterSmartCard();

// List available readers
final readers = await smartCard.listReaders();

// Connect to the first reader
if (readers.isNotEmpty) {
  await smartCard.connect(readers.first);

  // Send an APDU command (e.g. SELECT PSE)
  final pse = '1PAY.SYS.DDF01'.codeUnits;
  final response = await smartCard.transmit(
    Uint8List.fromList([0x00, 0xA4, 0x04, 0x00, pse.length, ...pse, 0x00]),
  );

  // Disconnect
  await smartCard.disconnect();
}

API Reference #