Getting Started
복사할 수 있는 지시
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-contacts`
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/contacts/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.
Capgo의 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-contacts` plugin in my project.만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요.
bun add @capgo/capacitor-contactsbunx cap syncImport
__CAPGO_KEEP_0__을 가져오기import { CapacitorContacts } from '@capgo/capacitor-contacts';API 개요
API 개요countContacts
__CAPGO_KEEP_0____CAPGO_KEEP_0__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.countContacts();createContact
__CAPGO_KEEP_0____CAPGO_KEEP_0__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createContact({} as CreateContactOptions);createGroup
__CAPGO_KEEP_0__새로운 연락처 그룹을 만들세요.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createGroup({} as CreateGroupOptions);deleteContactById
ID로 연락처 삭제하기ID로 연락처 삭제합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({} as DeleteContactByIdOptions);deleteGroupById
ID로 그룹 삭제하기ID로 그룹을 삭제합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({} as DeleteGroupByIdOptions);displayContactById
ID로 연락처를 표시합니다.ID로 연락처를 표시합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({} as DisplayContactByIdOptions);displayCreateContact
ID로 연락처 만들기__CAPGO_KEEP_0__을 사용하여 원본 연락처 UI를 표시합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayCreateContact();displayUpdateContactById
__CAPGO_KEEP_1____CAPGO_KEEP_0__을 사용하여 특정 연락처의 원본 연락처 UI를 표시합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayUpdateContactById({} as DisplayUpdateContactByIdOptions);getAccounts
__CAPGO_KEEP_2____CAPGO_KEEP_0__을 사용하여 장치에 있는 모든 계정 목록을 가져옵니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getAccounts();getContactById
__CAPGO_KEEP_3____CAPGO_KEEP_0__을 사용하여 특정 ID의 연락처를 가져옵니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContactById({} as GetContactByIdOptions);getContacts
__CAPGO_KEEP_4____CAPGO_KEEP_0__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContacts();getGroupById
__CAPGO_KEEP_2____CAPGO_KEEP_3__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroupById({} as GetGroupByIdOptions);getGroups
__CAPGO_KEEP_4____CAPGO_KEEP_5__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroups();isAvailable
__CAPGO_KEEP_2____CAPGO_KEEP_6__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isAvailable();isSupported
__CAPGO_KEEP_7__현재 플랫폼에서 플러그인이 지원되는지 확인합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isSupported();openSettings
openSettings 섹션장치의 연락처 설정을 열어줍니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.openSettings();pickContact
pickContact 섹션자연스러운 연락처 선택기를 사용하여 단일 연락처를 선택합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
pickContacts 섹션자연스러운 연락처 선택기를 사용하여 하나 이상의 연락처를 선택합니다.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
updateContactById 섹션__CAPGO_KEEP_0__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
__CAPGO_KEEP_2____CAPGO_KEEP_3__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
__CAPGO_KEEP_2____CAPGO_KEEP_4__
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.requestPermissions();__CAPGO_KEEP_5__
__CAPGO_KEEP_2__CountContactsResult
__CAPGO_KEEP_6____CAPGO_KEEP_7__
export interface CountContactsResult { /** * Total number of contacts. * * @since 1.0.0 */ count: number;}CreateContactOptions
__CAPGO_KEEP_1__ (연락처 만들기 옵션)연락처 만들기 옵션입니다.
export interface CreateContactOptions { /** * Contact information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ contact: Omit<Contact, 'id'>;}CreateContactResult
__CAPGO_KEEP_1__ (연락처 만들기 결과)연락처 만들기 결과입니다.
export interface CreateContactResult { /** * The ID of the newly created contact. * * @since 1.0.0 */ id: string;}CreateGroupOptions
__CAPGO_KEEP_1__ (그룹 만들기 옵션)그룹 만들기 옵션입니다.
export interface CreateGroupOptions { /** * Group information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ group: Omit<Group, 'id'>;}CreateGroupResult
__CAPGO_KEEP_1__ (그룹 만들기 결과)그룹 만들기 결과입니다.
export interface CreateGroupResult { /** * The ID of the newly created group. * * @since 1.0.0 */ id: string;}DeleteContactByIdOptions
__CAPGO_KEEP_1____CAPGO_KEEP_2__
export interface DeleteContactByIdOptions { /** * The ID of the contact to delete. * * @since 1.0.0 */ id: string;}DeleteGroupByIdOptions
__CAPGO_KEEP_1____CAPGO_KEEP_3__
export interface DeleteGroupByIdOptions { /** * The ID of the group to delete. * * @since 1.0.0 */ id: string;}DisplayContactByIdOptions
__CAPGO_KEEP_1____CAPGO_KEEP_4__
export interface DisplayContactByIdOptions { /** * The ID of the contact to display. * * @since 1.0.0 */ id: string;}DisplayCreateContactOptions
__CAPGO_KEEP_1____CAPGO_KEEP_5__
export interface DisplayCreateContactOptions { /** * Optional pre-filled contact information for the create UI. * * @since 1.0.0 */ contact?: Omit<Contact, 'id'>;}DisplayCreateContactResult
DisplayCreateContactResult 섹션 제목자연스러운 연락처 만들기 UI를 표시한 결과.
export interface DisplayCreateContactResult { /** * The ID of the created contact, if one was created. Undefined if the user cancelled. * * @since 1.0.0 */ id?: string;}DisplayUpdateContactByIdOptions
DisplayUpdateContactByIdOptions 섹션 제목자연스러운 연락처 업데이트 UI를 표시하는 옵션.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
GetAccountsResult 섹션 제목계정 가져오기 결과.
export interface GetAccountsResult { /** * List of accounts available on the device. * * @since 1.0.0 */ accounts: Account[];}실제 데이터 원본
Source Of Truth 섹션 제목This page is generated from the plugin’s src/definitions.ts Re-run the sync when the public API changes upstream.
Getting Started에서 계속
Getting Started에서 계속하는 섹션Capacitor를 사용 중이라면 Getting Started Capacitor를 사용 중이라면 대시보드와 API 연산을 계획하고 싶다면 @capgo/capacitor-contacts를 사용하여 @capgo/capacitor-contacts를 사용하여 native capability를 구현하는 경우 API 개요 API 개요에서 구현 세부 정보를 확인하는 경우 소개 __CAPGO_KEEP_0__ API 키 API 키의 구현 세부 사항, 및 장치 __CAPGO_KEEP_0__ 키의 구현 세부 사항.