Flutter原生认证插件native_auth的使用

native_auth 是一个用于在Flutter应用中集成设备生物识别系统的插件，支持Android和iOS平台。通过这个插件，开发者可以轻松地利用FaceID、TouchID或指纹识别来增强应用的安全性。

如何使用

首先，在你的Dart文件顶部导入 native_auth 包：

import 'package:native_auth/native_auth.dart';

然后你可以调用 Auth.isAuthenticate() 方法来进行生物识别认证，并根据返回的结果采取相应行动。下面是一个简单的例子：

final response = await Auth.isAuthenticate();
print(response.isAuthenticated); // true or false

这里 response 是一个枚举类型 AuthResult 的实例，包含三种可能的状态：

• auth: 用户已成功通过认证。
• noAuth: 用户未通过认证。
• error: 无法请求任何生物识别信息（例如用户没有设置指纹或面部识别）。

示例代码

下面是一个完整的示例程序，演示了如何在Flutter应用中使用 native_auth 插件进行生物识别认证：

import 'dart:developer';
import 'package:flutter/material.dart';
import 'package:native_auth/native_auth.dart';

void main() => runApp(const MyApp());

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Flutter Demo',
      home: HomePage(),
    );
  }
}

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

  @override
  createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  String valueAuth = "No initialized";

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Auth")),
      bottomNavigationBar: buttonAuth(),
      body: Center(child: Text(valueAuth)),
    );
  }

  Widget buttonAuth() {
    return SafeArea(
      child: Padding(
        padding: const EdgeInsets.symmetric(horizontal: 20),
        child: ElevatedButton(onPressed: auth, child: const Text("Auth me")),
      ),
    );
  }

  Future<void> auth() async {
    final response = await Auth.isAuthenticate();
    log('is authenticated: ${response.isAuthenticated}');
    setState(() {
      valueAuth = response.toString();
    });
  }
}

在这个例子中，当用户点击“Auth me”按钮时，将触发 auth 函数执行生物识别认证过程，并更新界面上显示的认证状态。

平台配置

iOS集成

为了使iOS设备能够正常使用Face ID功能，请确保在项目的 Info.plist 文件中添加以下权限说明：

<key>NSFaceIDUsageDescription</key>
<string>Why is my app authenticating using face id?</string>

Android集成

对于Android设备，你需要在 AndroidManifest.xml 文件中声明使用指纹识别的权限：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
 package="com.example.app">
  <uses-permission android:name="android.permission.USE_BIOMETRIC"/>
</manifest>

同时还需要修改 MainActivity.kt 或者 MainActivity.java 文件，继承自 FlutterFragmentActivity 类，以确保Flutter视图正确加载：

// MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity() {
    // ...
}

// OR

// MainActivity.java
import io.flutter.embedding.android.FlutterFragmentActivity;

public class MainActivity extends FlutterFragmentActivity {
    // ...
}

这样就完成了对 native_auth 插件的基本配置与使用介绍。希望这些信息能帮助你在自己的项目中顺利实现生物识别认证功能！