Flutter生物识别认证插件flutter_biometric_auth的使用

Flutter生物识别认证插件flutter_biometric_auth的使用

概述

flutter_biometric_auth 是一个用于轻松实现生物识别认证的 Flutter 插件。它利用了 iOS 的 Touch ID 和 Face ID 技术，使用户可以通过触摸或面部扫描轻松完成身份验证。

关键特性

  • 安全认证：利用 Apple 的高级生物识别技术确保用户身份验证的安全性。
  • 支持 Touch ID 和 Face ID：无缝集成 Touch ID 和 Face ID 认证方法，为用户提供便捷的身份验证选项。
  • 易于集成：简化了 Flutter 插件架构，可以轻松集成到现有的 Flutter 项目中，减少开发时间和工作量。

使用前准备

在使用 flutter_biometric_auth 插件之前，请确保在 Flutter 项目的 iOS 文件夹中的 Info.plist 文件中添加以下键值对：

<key>NSFaceIDUsageDescription</key>
<string>Face ID authentication</string>

这将允许应用访问本地认证功能。

完整示例代码

以下是使用 flutter_biometric_auth 插件的完整示例代码：

import 'dart:developer';

import 'package:flutter/material.dart';

import 'package:flutter/services.dart';
import 'package:faceid/faceid.dart'; // 引入 flutter_biometric_auth 插件

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

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

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

class _MyAppState extends State<MyApp> {
  final _faceidPlugin = Faceid(); // 初始化 Faceid 插件实例

  bool _isAuthenticated = false; // 用于存储认证状态

  void _authenticate() async {
    try {
      // 调用 authenticate 方法进行生物识别认证
      final isAuthenticated = await _faceidPlugin.authenticate();
      setState(() {
        // 更新认证状态
        _isAuthenticated = isAuthenticated;
      });
    } on PlatformException catch (e) {
      // 捕获并记录认证失败的错误信息
      log('Failed to authenticate: ${e.message}', error: e);
    }
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('生物识别认证示例'), // 设置应用标题
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center, // 垂直居中排列
            children: [
              // 点击按钮触发认证
              InkWell(
                onTap: _authenticate,
                child: const Text('点击以获取权限', style: TextStyle(fontSize: 18)),
              ),
              const SizedBox(height: 20), // 添加间距
              // 根据认证状态显示不同的文本
              _isAuthenticated
                  ? const Text('已认证', style: TextStyle(fontSize: 18, color: Colors.green))
                  : const Text('未认证', style: TextStyle(fontSize: 18, color: Colors.red)),
            ],
          ),
        ),
      ),
    );
  }
}

更多关于Flutter生物识别认证插件flutter_biometric_auth的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter生物识别认证插件flutter_biometric_auth的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


flutter_biometric_auth 是一个用于在 Flutter 应用中实现生物识别认证的插件。它支持指纹、面部识别等生物识别技术，并提供简单的 API 来管理认证流程。

以下是如何在 Flutter 项目中使用 flutter_biometric_auth 插件的步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 flutter_biometric_auth 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_biometric_auth: ^1.0.0 # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在需要使用生物识别认证的地方导入插件：

import 'package:flutter_biometric_auth/flutter_biometric_auth.dart';

3. 检查设备是否支持生物识别

在尝试进行生物识别认证之前，最好先检查设备是否支持生物识别功能：

bool isBiometricAvailable = await FlutterBiometricAuth.isBiometricAvailable();
if (isBiometricAvailable) {
  print("Biometric authentication is available.");
} else {
  print("Biometric authentication is not available.");
}

4. 检查已注册的生物识别类型

你可以检查设备上已注册的生物识别类型（如指纹、面部识别等）：

List<BiometricType> availableBiometrics = await FlutterBiometricAuth.getAvailableBiometrics();
if (availableBiometrics.contains(BiometricType.fingerprint)) {
  print("Fingerprint is available.");
}
if (availableBiometrics.contains(BiometricType.face)) {
  print("Face recognition is available.");
}
if (availableBiometrics.contains(BiometricType.iris)) {
  print("Iris recognition is available.");
}

5. 进行生物识别认证

使用 authenticate 方法来进行生物识别认证：

try {
  bool isAuthenticated = await FlutterBiometricAuth.authenticate(
    localizedReason: 'Please authenticate to access this feature',
    useErrorDialogs: true,
    stickyAuth: true,
  );

  if (isAuthenticated) {
    print("Authentication successful.");
  } else {
    print("Authentication failed.");
  }
} catch (e) {
  print("Error during authentication: $e");
}

6. 处理认证结果

根据认证结果，你可以执行相应的操作。例如，如果认证成功，可以允许用户访问某些敏感信息或功能。

7. 处理错误

在认证过程中，可能会遇到各种错误，例如用户取消认证、设备不支持生物识别等。你可以使用 try-catch 块来捕获并处理这些错误。

8. 配置 Android 和 iOS

Android

在 AndroidManifest.xml 中添加以下权限：

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

iOS

在 Info.plist 中添加以下描述：

<key>NSFaceIDUsageDescription</key>
<string>We need to use Face ID to secure your data.</string>

示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_biometric_auth 进行生物识别认证：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: BiometricAuthScreen(),
    );
  }
}

class BiometricAuthScreen extends StatelessWidget {
  Future<void> _authenticate() async {
    try {
      bool isBiometricAvailable = await FlutterBiometricAuth.isBiometricAvailable();
      if (isBiometricAvailable) {
        bool isAuthenticated = await FlutterBiometricAuth.authenticate(
          localizedReason: 'Please authenticate to access this feature',
          useErrorDialogs: true,
          stickyAuth: true,
        );

        if (isAuthenticated) {
          print("Authentication successful.");
        } else {
          print("Authentication failed.");
        }
      } else {
        print("Biometric authentication is not available.");
      }
    } catch (e) {
      print("Error during authentication: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Biometric Authentication'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _authenticate,
          child: Text('Authenticate'),
        ),
      ),
    );
  }
}
回到顶部