@exodus/react-native-biometrics

中文文档
0.4.2发布于 2026/09/14MITCommonJS零依赖近 30 天下载 1.5万

反应原生生物计量

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 道具
  4. 安卓测试
  5. 许可证

@exodus/反应-亲生生物测定

Android平台的生物鉴别认证库,使用BiometricPrompt API.

安装

npm install @exodus/react-native-biometrics

使用量

import Biometrics from '@exodus/react-native-biometrics';

// ...

const valid = await Biometrics.authenticate(
  'Authenticate to continue',
  'Use your fingerprint to authenticate',
  'Cancel',
);

道具

名称类型说明
标题字符串生物鉴别提示的标题
字幕字符串生物鉴别提示的字幕
取消按钮文本字符串取消按钮的文本
倒计时 TOPasscode布尔允许设备 PIN,图案或密码作为生物鉴别学的替代品(默认: false(中文(简体) )

启用了密码回落,Android 10(API 29)使用系统证书 活动, 因此从指纹切换到 PIN 不取消认证 . 系统控制可用的认证方法,承诺解决了 从活动结果。 此活动可以背景化应用; 呼叫者必须保留 在整个过渡期间,尚未确认的认证是活的.

Android 9(API 28) 接受第2类(弱)或第3类(强)生物鉴别技术并同时接受 设备证书, 因为 AndroidX 不支持 BIOMETRIC_STRONG | DEVICE_CREDENTIAL 那个版本。 其他的Android版本, 继续需要第3类 生物鉴定 认证不使用 CryptoObject。 。 。 .

安卓测试

配有JDK 17,Gradle 8.12,Android SDK 36并安装了制造工具 36.0.0:

gradle -p test/android :biometrics:testDebugUnitTest

测试使用库中的 AndroidX 依赖和 Robolectric 验证快速 在API 27,28,29,和30上创建,包括之前被拒绝的组合. 还包括Android 10认证活动结果 取消 和 Stale 替换认证请求的结果.

许可证

麻省理工学院


制造的 创建- 反应- 本土- 图书馆

版本与发布记录

@exodus/react-native-biometrics 共发布 8 个版本,首次发布于 2024/11/01;过去 12 个月发布了 5 个版本。

版本发布日期距今
0.4.2latest2026/09/142 个月前
0.4.12026/09/112 个月前
0.4.02026/05/255 个月前
0.3.02025/12/2310 个月前
0.2.12025/12/0311 个月前
0.2.02025/10/211.1 年前

关于 @exodus/react-native-biometrics 的常见问题

@exodus/react-native-biometrics 是什么?

反应原生生物计量

如何安装 @exodus/react-native-biometrics?

在项目目录运行 npm install @exodus/react-native-biometrics,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、react-native(>=0.57.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@exodus/react-native-biometrics 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/exodus__react-native-biometrics 是否存在。

@exodus/react-native-biometrics 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@exodus/react-native-biometrics 可以商用吗?

@exodus/react-native-biometrics 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/react-native-biometrics 的下载量有多少?

根据 npm 官方下载统计,@exodus/react-native-biometrics 在 2026/10/14 – 2026/11/12 这 30 天内被下载 14,983 次,日均约 499 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/react-native-biometrics 还在维护吗?

最新版本 0.4.2 发布于 2026/09/14(2 个月前);至今共发布 8 个版本,其中过去 12 个月发布了 5 个;首次发布于 2024/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。