시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

그런 다음 아래 프롬프트를 사용하세요:

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';

빠른 시작

로그인 성공 시, OS에서 나중에 자동 완성할 수 있도록 자격 증명 저장을 제안합니다.

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

await SavePassword.promptDialog({
  username: email,
  password,
});

예시: 저장된 비밀번호 읽기

const { username, password } = await SavePassword.readPassword();

자주 하는 실수

• 호출 타이밍: 매 키 입력 시가 아니라, 사용자가 인증에 성공한 후에만 prompt를 띄웁니다.
• 웹: 대신 브라우저 비밀번호 관리자를 사용하세요. 이 플러그인은 네이티브 전용입니다.
• iOS 자격 증명 제공자: iOS 26.2+ 버전에서의 동작은 사용자가 선택한 비밀번호 관리자를 따릅니다.

API 개요

promptDialog

키체인에 비밀번호를 저장합니다.

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

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

readPassword

키체인에서 비밀번호를 읽어옵니다. iOS의 경우 개발자가 앱에 Associated Domain을 설정해야 합니다.

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;
}

Source of Truth

이 페이지는 플러그인의 src/definitions.tsupstream에서 public 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의 구현 세부 사항은, 2단계 인증 2단계 인증의 구현 세부 사항에 대해서는