iOS 设置

在 iOS 上，仅当应用程序与网站的依赖方域名相关联时，passkey 才会工作。

插件处理的内容

在添加插件配置并运行后 bunx cap sync插件将修补生成的 iOS 主机项目，使您不需要手动编辑它：

• 添加 webcredentials: 配置的域名的关联域名条目
• 连接 CODE_SIGN_ENTITLEMENTS 当生成的应用程序目标不指向一个特权文件时

您仍需要托管

您必须发布 apple-app-site-association 在依赖方域名：

https://signin.example.com/.well-known/apple-app-site-association

示例：

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

检查清单

1. 设置 origin 和 domains 在 plugins.CapacitorPasskey 在 capacitor.config.*.
2. Run bunx cap sync.
3. 确认您的Apple Team ID和app bundle ID，然后构建 TEAMID.bundleId __CAPGO_KEEP_0__
4. Host apple-app-site-association 使用HTTP 200 且无 .json 扩展
5. 确保您的后端使用的依赖方ID与关联域名匹配。

Notes

• 必须从您用作依赖方ID的exact passkey域名中服务的网站文件中获取。
• 在 iOS 17.4 及更高版本中，插件使用浏览器样式的客户端数据 API，因此配置的 HTTPS 源将反映在 clientDataJSON.
• 插件可以在同步期间修补本机项目文件，但它无法创建或托管您的域上的网站关联文件。