# @exodus/react-native-biometrics 中文文档

规范地址：https://npmcn.com/package/%40exodus/react-native-biometrics/

版本：0\.4\.2
npm 元数据更新时间：2026-09-14T02:50:07.297Z
中文译文更新时间：2026-11-14T04:00:11.693Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40exodus/react-native-biometrics
原文对照：https://npmcn.com/package/%40exodus/react-native-biometrics/?lang=original
项目主页：https://github.com/ExodusMovement/react-native-biometrics#readme
源码仓库：https://github.com/ExodusMovement/react-native-biometrics

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：17.4 kB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：react \>=16\.8\.0，react-native \>=0\.57\.0
- 首次发布：2024-11-01T08:48:31.613Z
- 最新版本发布：2026-09-14T02:50:07.127Z
- 近 30 天下载量：14983（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 5 个）

## 中文简介

反应原生生物计量

## 安装

```sh
npm install @exodus/react-native-biometrics
```

也可以使用：`pnpm add @exodus/react-native-biometrics`、`yarn add @exodus/react-native-biometrics`、`bun add @exodus/react-native-biometrics`

## README

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

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

## 安装

```sh
npm install @exodus/react-native-biometrics
```

## 使用量

```js
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:

```sh
gradle -p test/android :biometrics:testDebugUnitTest
```

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

## 许可证

麻省理工学院

* * *

制造的 [创建- 反应- 本土- 图书馆](https://github.com/callstack/react-native-builder-bob)

## 常见问题

### @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 和提交记录判断。