跳转到正文

快速入门

GitHub

你可以使用我们的 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-password
bunx 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+ 上,具体行为取决于用户选择的密码管理器。

将密码保存到 Keychain。

import { SavePassword } from '@capgo/capacitor-autofill-save-password';
await SavePassword.promptDialog({
username: 'your-username',
password: 'your-password'
});

从 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.
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;
}
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 中的实现细节, 双因素认证 有关双重身份验证的实现细节。