14天的免费试用，无需信用卡

安装

您可以使用我们的AI辅助设置来安装插件。使用以下命令将Capgo技能添加到您的AI工具中：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-passkey` plugin in my project.

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作:

1. 安装包

   bun add @capgo/capacitor-passkey

2. 同步本机项目

   bunx cap sync

3. 添加插件配置

   import type { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     appId: 'app.capgo.passkey.example',
     appName: 'My App',
     webDir: 'dist',
     plugins: {
       CapacitorPasskey: {
         origin: 'https://signin.example.com',
         autoShim: true,
         domains: ['signin.example.com'],
       },
     },
   };
   
   export default config;

4. 在引导期间安装 shim

   import { CapacitorPasskey } from '@capgo/capacitor-passkey';
   
   await CapacitorPasskey.autoShimWebAuthn();

5. 保持正常的 WebAuthn 流程

   const registration = await navigator.credentials.create({
     publicKey: registrationOptions,
   });
   
   const authentication = await navigator.credentials.get({
     publicKey: requestOptions,
   });

插件配置的作用

配置从 plugins.CapacitorPasskey 在 capacitor.config.*.

• origin: primary HTTPS relying-party origin used by the shim and direct API
• domains: 需要在本地配置中同步的额外依赖方主机名
• autoShim: 默认值 true 和控制原生 cap sync 自动配置钩子

为你同步补丁

当你运行 bunx cap sync, 插件更新生成的原生主机项目：

• iOS：域关联权限和 Xcode 权限编排（当需要时）
• Android： asset_statements 元数据和生成的资源（由清单使用）

钩子不会为你发布网站信任文件。您仍然需要托管：

• https://your-domain/.well-known/apple-app-site-association
• https://your-domain/.well-known/assetlinks.json

平台指南

iOS设置

关联域名和 apple-app-site-association.

Android设置

数字资产链接和 assetlinks.json.

后端说明

起源验证和Android注意事项。

继续从Getting Started

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