Flutter中使用DigitalPersona U.are.U 4500实现指纹登录及Firebase验证咨询

核心思路 #

Flutter没有直接支持DigitalPersona U.are.U 4500的第三方插件，因此需要通过**Flutter平台通道（Platform Channel）**调用原生Android的DigitalPersona SDK完成指纹扫描，再将扫描得到的指纹特征数据与Firebase数据库中存储的用户数据比对，实现登录逻辑。

一、原生Android端集成DigitalPersona SDK #

1. 导入SDK依赖 #

从DigitalPersona官方获取U.are.U 4500的Android SDK，将SDK的.jar或.aar文件放到android/app/libs目录下，然后在android/app/build.gradle中添加依赖：

dependencies {
    implementation files('libs/DPUareUSDK.jar') // 替换为实际SDK文件名
}

2. 实现平台通道通信 #

在MainActivity.kt中创建MethodChannel，处理Flutter发起的扫描请求，调用SDK完成指纹扫描并返回特征数据：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import com.digitalpersona.uareu.*
import android.util.Base64

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.yourapp/fingerprint_scanner" // 自定义通道名称
    private var device: Device? = null
    private var reader: Reader? = null

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "startScan" -> startFingerprintScan(result)
                else -> result.notImplemented()
            }
        }
    }

    private fun startFingerprintScan(result: MethodChannel.Result) {
        try {
            // 初始化设备管理器
            val deviceManager = DeviceManager(context)
            val devices = deviceManager.getDevices()
            if (devices.isEmpty()) {
                result.error("NO_DEVICE", "未检测到指纹扫描仪", null)
                return
            }

            // 打开设备并获取阅读器
            device = devices[0]
            device?.open(Device.Priority.EXCLUSIVE)
            reader = device?.getReader()

            // 开始指纹捕获
            reader?.Capture(
                Fid.Format.ANSI_378_2004,
                Reader.ImageProcessing.IMG_PROC_DEFAULT,
                null,
                null,
                object : Reader.CaptureCallback {
                    override fun onCapture(fid: Fid?, image: Wsq?, r: Reader?) {
                        device?.close()
                        fid?.let {
                            // 将指纹特征数据转为Base64字符串返回给Flutter
                            val fingerprintBase64 = Base64.encodeToString(it.data, Base64.DEFAULT)
                            result.success(fingerprintBase64)
                        } ?: result.error("SCAN_FAIL", "未捕获到指纹数据", null)
                    }

                    override fun onException(e: Exception?, r: Reader?) {
                        device?.close()
                        result.error("EXCEPTION", "扫描出错：${e?.message}", null)
                    }
                }
            )
        } catch (e: Exception) {
            result.error("INIT_FAIL", "扫描仪初始化失败：${e.message}", null)
        }
    }
}

3. 添加权限 #

在AndroidManifest.xml中添加USB设备访问权限：

<uses-permission android:name="android.permission.USB_PERMISSION" />

需要额外处理USB权限请求逻辑，确保应用能访问连接的指纹扫描仪。

二、Flutter端实现 #

1. 封装扫描方法 #

创建工具类通过MethodChannel调用原生扫描方法：

import 'package:flutter/services.dart';

class FingerprintScanner {
  static const _channel = MethodChannel('com.yourapp/fingerprint_scanner');

  static Future<String?> startScan() async {
    try {
      return await _channel.invokeMethod('startScan');
    } on PlatformException catch (e) {
      print("扫描错误：${e.message}");
      return null;
    }
  }
}

2. 登录逻辑与UI #

实现登录页面，调用扫描方法后与Firebase数据比对：

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

class FingerprintLoginPage extends StatefulWidget {
  const FingerprintLoginPage({super.key});

  @override
  State<FingerprintLoginPage> createState() => _FingerprintLoginPageState();
}

class _FingerprintLoginPageState extends State<FingerprintLoginPage> {
  final DatabaseReference _usersRef = FirebaseDatabase.instance.ref('users');
  bool _isScanning = false;

  Future<void> _handleLogin() async {
    setState(() => _isScanning = true);

    final fingerprintData = await FingerprintScanner.startScan();
    if (fingerprintData == null) {
      setState(() => _isScanning = false);
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('扫描失败，请重试')),
      );
      return;
    }

    // 查询Firebase中匹配指纹数据的用户
    final querySnapshot = await _usersRef
        .orderByChild('fingerprintData')
        .equalTo(fingerprintData)
        .get();

    if (querySnapshot.exists) {
      // 登录成功，处理用户状态
      final userData = querySnapshot.children.first.value as Map<String, dynamic>;
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('欢迎回来，${userData['username']}')),
      );
      // 跳转主页或保存用户信息
    } else {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('未找到匹配用户，请先注册')),
      );
    }

    setState(() => _isScanning = false);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('指纹登录')),
      body: Center(
        child: ElevatedButton(
          onPressed: _isScanning ? null : _handleLogin,
          child: _isScanning
              ? const CircularProgressIndicator(color: Colors.white)
              : const Text('开始指纹扫描'),
        ),
      ),
    );
  }
}

三、Firebase数据库结构 #

建议使用实时数据库，结构如下：

users
  - userId_xxxx
    - username: "张三"
    - email: "zhangsan@example.com"
    - fingerprintData: "Base64编码的指纹特征数据"
  - userId_yyyy
    - username: "李四"
    - email: "lisi@example.com"
    - fingerprintData: "Base64编码的指纹特征数据"

存储时仅保存指纹特征数据（而非原始图像），减少数据量并提升安全性。

四、注意事项 #

• 设备兼容性：确保Android设备支持USB Host模式，否则无法连接DigitalPersona扫描仪。
• 数据安全：指纹属于敏感信息，建议对存储在Firebase的指纹数据进行加密，同时配置数据库规则限制访问权限。
• 异常处理：原生端和Flutter端都需要处理设备未连接、扫描超时、权限不足等异常场景。

内容的提问来源于stack exchange，提问作者Haider Nawaz