@google-cloud/recaptcha-enterprise-react-native

中文文档
18.9.4发布于 2026/11/07ApacheTypeScriptESM + CJS零依赖近 30 天下载 31.9万

ReCAPTCHA 企业移动 SDK 本地插件

中文使用文档
文档目录12 节
  1. 设置
  2. 波德文件
  3. 基本用途
  4. 1. 进口回收
  5. 2. 初始化客户
  6. 3. 获取托肯
  7. 示例应用
  8. 常见问题:
  9. error: include of non-modular header inside framework modul…
  10. ` fatal 错误 : 'FlipperKit/ FlipperClient.h' 文件未找到 #import
  11. SDK 位置 未找到
  12. 不支持的类文件主版本 67

reCAPTCHA 企业反应原生模块

请注意,在该存储库中存档的问题不是官方Google 支持渠道,并在尽最大努力的基础上得到答复。 对于官方的支持, 请访问: https://cloud.google.com/support-hub 页面存档备份,存于互联网档案馆。 。 。 .

如果您对 React 本地插件有问题, 请在此张贴问题 仓库。 如果你对SDK有意见 请留言 内 https://github.com/GoogleCloudPlatform/recaptcha-企业-移动-sdk 互联网档案馆的存檔,存档日期2014-12-21。 。 。 .

关于用于移动应用的RECAPTCHA企业的一般文件见 机器人 财务报告和审定财务报表 iOS系统。 。 。 .

设置

[大 版本 18.9.4 后须 原生反应 >=0.87.0。 。 。 .

将软件包添加到您的 React 本地项目 :

npx yarn add @google-cloud/recaptcha-enterprise-react-native

如果使用 VSCode 安装 eslint :

https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint

您可能需要使用更老的 JDK :

export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home

波德文件

类似 基地,则 库需要框架和静态链接:

use_frameworks! :linkage => :static

翻转机与静态连接不兼容,因此无法在 波德文件 :

flipper_config = FlipperConfiguration.disabled

Swift 软件包管理器( SPM)

默认情况下, iOS 本地 SDK (RecaptchaEnterprise)通过CocoaPods安装. 在支持的回放原生版本上 spm_dependency 您可以选择解决本地问题 RecaptchaEnterprise iOS SDK 通过 Swift 软件包管理器代替设置 USE_SPM=1 (或 RECAPTCHA_USE_SPM=1运行时 pod install数字 :

USE_SPM=1 pod install

或者通过设置 ENV['RECAPTCHA_USE_SPM'] = '1' 在你的顶上 ios/Podfile。 。 。 .

基本用途

本节介绍如何与reCAPTCHA SDK集成.

1. 进口回收

使用下列出入口访问SDK提供的API.

import {
  Recaptcha,
  RecaptchaAction,
  type RecaptchaClient,
} from '@google-cloud/recaptcha-enterprise-react-native';

2. 初始化客户

通过使用您为您的Android/iOS应用程序创建的 reCAPTCHA 密钥( KEY ID) 来为客户端提供证据 .

const client = await Recaptcha.fetchClient(SITE_KEY);

[注] 您必须在应用程序使用期内只初始化一次 reCAPTCHA 客户端 .

3. 获取托肯

对于您使用 reCAPTCHA 保护的应用程序的每个动作, 请调用执行方法通过一个 RecaptchaAction. reCAPTCHA提供一套内置的动作,必要时可以创建 习惯动作.

以下代码片段显示如何使用执行来保护一个 LOGIN 行动.

const token = await client.execute(RecaptchaAction.LOGIN());

如果使用自定义动作 RecaptchaAction.custom('ACTION')· ;

示例应用

遵循指导 示例应用。 。 。 .

常见问题:

error: include of non-modular header inside framework module 'RecaptchaEnterprise.Recaptcha'

例如,在吊舱中使用静态连接: USE_FRAMEWORKS=static pod install 或者说 use_frameworks! :linkage => :static 在您的 Pod 文件中.

` fatal 错误 : 'FlipperKit/ FlipperClient.h' 文件未找到 #import

<FlipperKit/FlipperClient.h>`

Flipper 尚未兼容静态链接, 因此在您中禁用 Flipper 波德文件 : flipper_config = FlipperConfiguration.disabled

SDK 位置 未找到

在终端中运行以下命令 :

export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk

不支持的类文件主版本 67

这发生在一个不支持的Java版本被使用时. 运行

npx react-native doctor

要发现正在使用的版本和被支持的版本. 改变 java 版本到支持的版本并再次尝试.

版本与发布记录

@google-cloud/recaptcha-enterprise-react-native 共发布 23 个版本,首次发布于 2023/06/16;过去 12 个月发布了 7 个版本。

版本发布日期距今
18.9.4latest2026/11/0710 天前
18.9.32026/10/2721 天前
18.9.22026/07/164 个月前
18.9.12026/06/244 个月前
18.9.02026/06/244 个月前
18.9.0-beta012026/02/059 个月前

其他发布通道:beta → 18.8.0-beta02。

关于 @google-cloud/recaptcha-enterprise-react-native 的常见问题

@google-cloud/recaptcha-enterprise-react-native 是什么?

ReCAPTCHA 企业移动 SDK 本地插件

如何安装 @google-cloud/recaptcha-enterprise-react-native?

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

@google-cloud/recaptcha-enterprise-react-native 支持 TypeScript 吗?

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

@google-cloud/recaptcha-enterprise-react-native 支持 ESM 还是 CommonJS?

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

@google-cloud/recaptcha-enterprise-react-native 可以商用吗?

@google-cloud/recaptcha-enterprise-react-native 使用 Apache 许可。声明的许可为 Apache,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@google-cloud/recaptcha-enterprise-react-native 的下载量有多少?

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

@google-cloud/recaptcha-enterprise-react-native 还在维护吗?

最新版本 18.9.4 发布于 2026/11/07(10 天前);至今共发布 23 个版本,其中过去 12 个月发布了 7 个;首次发布于 2023/06/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。