Android Setup

站点密钥

在 Google Cloud reCAPTCHA 中创建一个 Android 移动应用密钥。注册您的 Capacitor 应用使用的包名，然后设置密钥在 capacitor.config.ts.

Android 使用 Google 的移动 reCAPTCHA SDK。在本插件中，仅在 Web 上可用的是常规、非企业版 reCAPTCHA v3; enterprise: false 在 Android 上被拒绝。

import type { CapacitorConfig } from '@capacitor/cli';
import '@capgo/capacitor-recaptcha';

const config: CapacitorConfig = {
  plugins: {
    Recaptcha: {
      androidSiteKey: 'ANDROID_SITE_KEY',
    },
  },
};

export default config;

依赖

该插件包含Google Android reCAPTCHA依赖项：

com.google.android.recaptcha:recaptcha:18.8.0

Google的Android reCAPTCHA SDK需要在消费应用中启用核心库的desugaring。该插件会自动在 npx cap sync android 和添加：

com.android.tools:desugar_jdk_libs:2.1.5

您可以从应用Gradle配置中覆盖依赖项版本， recaptchaVersion 当您需要将Google SDK的新版本固定时。 您可以覆盖desugaring依赖项， desugarJdkLibsVersion.

执行

import { Recaptcha } from '@capgo/capacitor-recaptcha';

const { token } = await Recaptcha.execute({
  action: 'checkout',
  timeout: 10000,
});

立即将令牌发送到您的后端并在接受受保护请求之前创建 reCAPTCHA 评估。

继续从 Android Setup

如果您正在使用 Android Setup 来规划身份验证和帐户流程，连接它与 使用 @capgo/capacitor-recaptcha 为 native 能力在使用 @capgo/capacitor-recaptcha 中 @capgo/capacitor-social-login 为实现细节在 @capgo/capacitor-social-login 中 @capgo/capacitor-passkey 为实现细节在 @capgo/capacitor-passkey 中 @capgo/capacitor-native-生物识别 为了了解 @capgo/capacitor-native-生物识别 的实现细节 双因素认证 为了了解双因素认证的实现细节