Android 配置

站点密钥

在 Google Cloud reCAPTCHA 中创建 Android 移动应用密钥。注册你的 Capacitor 应用所用的包名，然后在 capacitor.config.ts.

Android 使用 Google 的移动端 reCAPTCHA SDK。在此插件中，常规（非 Enterprise）reCAPTCHA v3 仅在 Web 端可用； 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 要求在接入应用中启用 core library 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,
});

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

从 Android Setup 继续

如果你正在使用 Android 配置 用来规划身份验证和账户流程，并将它与 使用 @capgo/capacitor-recaptcha 关于使用 @capgo/capacitor-recaptcha 时的原生能力， @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节， @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节， @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节， 双因素认证 有关双重身份验证的实现细节。