iOS 配置
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
在 iOS 上,只有当 App 和网站关联到同一个 Relying Party 域名时,Passkey 才能正常工作。
插件处理的内容
标题为“插件处理的内容”添加插件配置并运行后 bunx cap sync,插件会修补生成的 iOS 宿主项目,你无需再手动编辑:
- 添加
webcredentials:已配置域名的 associated domains 条目 - wires
CODE_SIGN_ENTITLEMENTS当生成的 App target 尚未指向 entitlements 文件时
仍需自行托管的内容
标题为“您仍需托管的内容”的章节您必须在 apple-app-site-association 依赖方域名上发布:
https://signin.example.com/.well-known/apple-app-site-association示例:
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}- 设置
origin以及domains中的plugins.CapacitorPasskey中的capacitor.config.*. - 运行
bunx cap sync. - 确认您的 Apple Team ID 和 App Bundle ID,然后构建
TEAMID.bundleId关联文件的值。 - 托管
apple-app-site-association使用 HTTP200并且没有.json扩展。 - 请确保后端使用的 relying-party ID 与关联域名一致。
备注
“注意事项”章节- 网站文件必须由你用作 relying-party ID 的那个 passkey 域名提供。
- 在 iOS 17.4 及更高版本上,插件使用浏览器风格的 client-data API,让配置的 HTTPS origin 体现在
clientDataJSON. - 该插件可以在 sync 期间修补原生项目文件,但无法在你的域名上创建或托管网站关联文件。
从 iOS Setup 继续
标题为“从 iOS 设置继续”的章节如果你正在使用 iOS 配置 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-passkey 在“使用 @capgo/capacitor-passkey”中了解原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节, 双因素认证 有关双重身份验证的实现细节。