让开源，少一点语言距离。
npm包中文文档

@castleio/react-native-castle

中文文档
4.1.0发布于 2026/10/12MITTypeScriptESM + CJS近 30 天下载 2.3万

反应原生城堡 SDK

中文使用文档
中文原文
文档目录12 节
  1. 所需资源
  2. 原生反应
  3. iOS系统
  4. 机器人
  5. 安装
  6. 线条
  7. 无
  8. 在iOS上连接本地代码
  9. Android上的本地密码
  10. 使用量
  11. 捐款
  12. 许可证

本土反应城堡

城堡 在您的认证堆栈中添加实时监控, 立即通知您和您的用户可能的账户被劫持 .

npm License CircleCI

注: 版本 4.0.0 与以往相比有断开的更改 2.x.x 各个版本。 安卓现在需要8.0+(minSdkVersion 26号, compileSdkVersion 36),因此支持API 24-25的应用无法升级,iOS的部署目标由12.0提高到了13.0. 此外:

  • userAgent(), (中文(简体) ), queueSize() 编辑 sensorTrackingEnabled 选项已删除.
  • flushIfNeeded() 财务报告和审定财务报表 baseUrl() 仅是iOS。 安得罗德 flushIfNeeded() 是一个不开放和 baseUrl() 决定 null。 。 。 .
  • createRequestToken() 决定 null 在 SDK 配置之前, 而不是空字符串 .
  • configure() 财务报告和审定财务报表 configureWithPublishableKey() 当配置失败而不是解决时拒绝承诺 .
  • baseURLAllowList 条目必须包含一个方案,例如 https://api.example.com。 。 。 .

见 变化 完整名单.

所需资源

原生反应

  • 反应原生 0.77.0+

iOS系统

  • iOS 15.1+ (韩语)
  • X码16.3+

机器人

  • Android 8.0 (API 26) (英语)
  • 编译SdkVersion 36

安装

添加数据 @castleio/react-native-castle 给您的软件包 package.json。 。 。 .

线条

yarn add @castleio/react-native-castle

无

npm install --save @castleio/react-native-castle

在iOS上连接本地代码

运行 pod install 输入 ios 要链接到本地的 iOS 项目 。 不切换目录的快捷方式是运行

npx pod-install

Castle iOS SDK飞船作为二进制的XCF框架在此包内销售,所以 可可Pods链接,嵌入 并签名给你。 不需要额外的 Podfile 设置 .

完成后, 重建应用程序二进制并开始使用库

npx react-native run-ios

Android上的本地密码

为了开始使用库,你需要重建应用程序二进制

npx react-native run-android

使用量

请看 移动融合指南。 。 。 .

捐款

见 贡献指南 学习如何为储存库和发展工作流程作出贡献.

许可证

麻省理工学院

版本与发布记录

@castleio/react-native-castle 共发布 46 个版本，首次发布于 2021/03/11；过去 12 个月发布了 9 个版本。

版本发布日期距今
4.1.0latest2026/10/1227 天前
4.0.12026/09/161 个月前
4.0.02026/08/262 个月前
2.3.02026/05/285 个月前
2.0.15legacy2026/04/176 个月前
2.2.82026/01/279 个月前

关于 @castleio/react-native-castle 的常见问题

@castleio/react-native-castle 是什么？

反应原生城堡 SDK

如何安装 @castleio/react-native-castle？

在项目目录运行 npm install @castleio/react-native-castle，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（*）、react-native（*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@castleio/react-native-castle 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@castleio/react-native-castle 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@castleio/react-native-castle 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js ^22.22.2 || ^24.15.0 || >=26.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@castleio/react-native-castle 可以商用吗？

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

@castleio/react-native-castle 的下载量有多少？

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

@castleio/react-native-castle 还在维护吗？

最新版本 4.1.0 发布于 2026/10/12（27 天前）；至今共发布 46 个版本，其中过去 12 个月发布了 9 个；首次发布于 2021/03/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。