Flutter 实战:使用 local_auth 实现生物识别(指纹/Face ID)

欢迎关注微信公众号:FSA全栈行动 👋

一、概述

在开发金融类或者涉及隐私的应用时,指纹识别或 Face ID 的身份验证是必不可少的。在 Flutter 中,我们通常会直接使用官方维护的 local_auth 库来解决这个问题。

不过,这个插件不仅仅是简单的 pub add 那么简单,因为涉及到生物识别权限,我们需要在 Android 和 iOS 的原生配置层进行一些"脏活累活"的调整,否则运行时会直接报错或无法唤起识别界面。

二、环境准备

首先,在项目的 pubspec.yaml 文件中引入 local_auth:

YAML 复制代码
dependencies:
  local_auth: ^latest_version

然后执行 flutter pub get 同步依赖。

三、原生配置

原生层的配置是这个插件能否跑通的关键。

1、Android 端配置

Android 端有两个地方需要动手术。

1.1 修改 MainActivity.kt

由于生物识别需要调用系统的 Fragment 机制,默认的 FlutterActivity 可能无法满足需求。我们需要把 MainActivity 的继承关系改掉。

找到 android/app/src/main/kotlin/.../MainActivity.kt,修改如下:

Kotlin 复制代码
import io.flutter.embedding.android.FlutterFragmentActivity // 替换掉 FlutterActivity

class MainActivity: FlutterFragmentActivity() { // 替换掉 FlutterActivity
}

1.2 配置权限与主题

在 android/app/src/main/AndroidManifest.xml 中,添加生物识别权限:

XML 复制代码
<manifest ...>
    <!-- 添加生物识别权限 -->
    <uses-permission android:name="android.permission.USE_BIOMETRIC" />

    <application ...>
        ...
    </application>
</manifest>

另外,要注意 Android 的主题配置。如果你的应用需要更现代的界面交互,建议在 android/app/src/main/res/values/styles.xml 中,将 LaunchTheme 和 NormalTheme 的 parent 属性从 Theme.Light.NoTitleBar 改为 Theme.AppCompat.DayNight。

XML 复制代码
<resources>
    <style name="LaunchTheme" parent="Theme.AppCompat.DayNight">
        <item name="android:windowBackground">@drawable/launch_background</item>
    </style>
    <style name="NormalTheme" parent="Theme.AppCompat.DayNight">
        <item name="android:windowBackground">?android:colorBackground</item>
    </style>
</resources>

2、iOS 端配置

iOS 端相对简单,但如果你不配置 Face ID 的描述文案,调用时应用会直接崩溃。

打开 ios/Runner/Info.plist,在 <dict> 标签内添加以下配置:

XML 复制代码
<key>NSFaceIDUsageDescription</key>
<string>我们需要使用 Face ID 来确保您的账户安全</string>

注意:这里的 string 内容可以根据你的应用实际需求进行自定义。

四、代码实现

配置完原生环境后,我们就可以在 Dart 代码里封装一个 BiometricService 来进行调用了。

Dart 复制代码
import 'package:flutter/material.dart';
import 'package:local_auth/local_auth.dart';
import 'package:local_auth_android/local_auth_android.dart';
import 'package:local_auth_ios/local_auth_ios.dart';

class BiometricService {
  static final LocalAuthentication localAuth = LocalAuthentication();

  /// 执行身份验证
  static Future<bool> authenticateLocally() async {
    bool isAuthenticate = false;
    try {
      isAuthenticate = await localAuth.authenticate(
          localizedReason: '我们需要验证您的身份以继续使用',
          options: const AuthenticationOptions(
              stickyAuth: true, // 应用切到后台再切回时,验证不中断
              biometricOnly: true, // 只允许生物识别,不允许 PIN 码
              sensitiveTransaction: false,
              useErrorDialogs: true));
    } catch (e) {
      // 这里可以根据需要调用全局 Snackbar 提示错误
      debugPrint('认证过程中发生错误: $e');
    }
    return isAuthenticate;
  }

  /// 检查设备是否支持生物识别
  static Future<void> checkBiometrics() async {
    try {
      final bool canCheck = await localAuth.canCheckBiometrics;
      final bool isSupported = await localAuth.isDeviceSupported();
      final List<BiometricType> biometrics = await localAuth.getAvailableBiometrics();

      debugPrint('================================');
      debugPrint('设备支持生物识别: $canCheck');
      debugPrint('硬件支持情况: $isSupported');
      debugPrint('可用生物识别类型: $biometrics');
      debugPrint('================================');
    } catch (e) {
      debugPrint('检查生物识别时报错: $e');
    }
  }
}

五、最后

在这里,我建议在实际项目中调用 checkBiometrics 来判断当前设备是否具备验证条件,从而决定是否在 UI 上展示指纹/FaceID 的图标。

如果在使用过程中遇到 FlutterFragmentActivity 相关的报错,记得检查 MainActivity.kt 是否真的改对了。本篇到此结束。

如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号:FSA全栈行动, 这将是对我最大的激励. 公众号不仅有Android技术, 还有iOS, Python等文章, 可能有你想要了解的技能知识点哦~

相关推荐
HMS工业网络6 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全
知白映川8 小时前
一个不上传数据的工具,怎么知道自己有没有人用
安全·架构
山东科恩光电8 小时前
安全地毯压敏传感技术在自动化产线与仓储区域的人员检测及联动停机防护方案
安全
如夏倾城14 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
0xBADCODE14 小时前
2026 工业互联网安全大赛 · 全国预选赛题解系列密码学方向 crypto-5
网络·安全·web安全·网络安全·系统安全·密码学
恋猫de小郭15 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
好的佩奇1 天前
蓝牙之设备角色与连接
android·flutter·蓝牙
Flynt1 天前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
地平线开发者1 天前
让 AI Agent 和 征程6 台架高效、稳定、安全地协作
算法·安全·自动驾驶
艾莉丝努力练剑1 天前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全