Android设置

在 Android 上，passkey 与您的网站一起工作，前提是应用程序和依赖方域名通过数字资产链接连接。

插件处理的内容

您添加插件配置并运行后 bunx cap sync, 插件将修补生成的 Android 主机项目：

• 注入 asset_statements 清单元数据
• 写入生成的字符串资源，引用该元数据

您需要托管的内容

您必须发布 assetlinks.json 在依赖方域名上：

https://signin.example.com/.well-known/assetlinks.json

示例：

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls",
      "delegate_permission/common.get_login_creds"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "app.capgo.passkey.example",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99"
      ]
    }
  }
]

检查清单

1. 设置 origin and domains in plugins.CapacitorPasskey in capacitor.config.*.
2. 开始 bunx cap sync.
3. 使用您的真实 Android 包名 assetlinks.json.
4. 添加您需要的每个签名证书指纹，包括调试或内部签名密钥，如果您测试这些构建
5. 在您使用的依赖方 ID 的相同域名上托管该文件

与浏览器的重要行为差异

通过配置数字资产链接，Android 可以使用相同的依赖方和 passkeys 作为您的网站。剩余的差异是本机报告的原始起源 clientDataJSON.

• 一个正常的 Android 应用程序不会像特权浏览器一样行为
• 断言起源可以与 Android 应用程序签名绑定而不是您的网站起源
• 如果您的后端严格验证 clientDataJSON.origin，接受 Android 应用程序起源和网站起源

继续从 Android 设置

如果您正在使用 Android设置 来规划身份验证和帐户流程，连接它 使用@capgo/capacitor-passkey 为native能力在使用@capgo/capacitor-passkey @capgo/capacitor-社交登录 为实现细节在@capgo/capacitor-social-login @capgo/capacitor-passkey 为实现细节在@capgo/capacitor-passkey @capgo/capacitor-native-biometric 为实现细节在@capgo/capacitor-native-biometric 双因素认证 双因素认证的实现细节。