快速入门

复制一条配置 prompt，包含安装步骤和该插件的完整 Markdown 指南。

        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-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+ 上的行为遵循用户选择的密码管理器。

API 概览

`promptDialog`

将密码保存到 keychain。

import { SavePassword } from '@capgo/capacitor-autofill-save-password';

await SavePassword.promptDialog({
  username: 'your-username',
  password: 'your-password'
});

`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`

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`

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 中的实现细节，以及双重身份验证了解双因素认证中的实现细节。