快速入门
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-autofill-save-password`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/autofill-save-password/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
安装
“安装”章节你可以使用我们的 AI 辅助设置来安装插件。使用以下命令将 Capgo skills 添加到你的 AI 工具中:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins然后使用以下 prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-autofill-save-password` plugin in my project.如果你更想手动设置,请运行以下命令安装插件,并按照下方各平台的说明操作:
bun add @capgo/capacitor-autofill-save-passwordbunx cap sync导入
“导入”章节import { SavePassword } from '@capgo/capacitor-autofill-save-password';快速入门
章节标题为“快速入门”登录成功后,提示用户保存凭据,以便后续由操作系统自动填充。
import { SavePassword } from '@capgo/capacitor-autofill-save-password';
await SavePassword.promptDialog({ username: email, password,});示例:读取已保存的密码
章节标题:“示例:读取已保存的密码”const { username, password } = await SavePassword.readPassword();常见坑点
章节标题为“常见陷阱”- 调用时机:仅在用户成功通过身份验证后提示,而不是每次按键都提示。
- Web 端:请改用浏览器密码管理器,此插件仅支持原生环境。
- iOS 凭据提供程序:在 iOS 26.2+ 上,具体行为取决于用户选择的密码管理器。
API 概览
章节标题:“API 概览”promptDialog
标题为“promptDialog”的章节将密码保存到 Keychain。
import { SavePassword } from '@capgo/capacitor-autofill-save-password';
await SavePassword.promptDialog({ username: 'your-username', password: 'your-password'});readPassword
标题为“readPassword”的章节从 Keychain 读取密码。iOS 上需要开发者为 App 配置 Associated Domains。
import { SavePassword } from '@capgo/capacitor-autofill-save-password';
const result = await SavePassword.readPassword();// The result holds sensitive values: use it without logging it.类型参考
“类型参考” 章节Options
标题为“Options”的章节export interface Options { /** * The username to save. */ username: string; /** * The password to save. */ password: string; /** * The url to save the password for. (For example: "console.capgo.app") * iOS only. */ url?: string;}ReadPasswordResult
标题为“ReadPasswordResult”的章节export interface ReadPasswordResult { /** * The username of the password. */ username: string; /** * The password of the password. */ password: string;}单一事实来源
标题为“单一事实来源”的部分本页面由插件的 src/definitions.ts生成。当上游的公共 API 发生变化时,请重新运行 sync。
从入门指南继续
“从入门指南继续”章节如果你正在使用 快速入门 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-autofill-save-password 用于“使用 @capgo/capacitor-autofill-save-password”中的原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节, 双因素认证 有关双重身份验证的实现细节。