Iniziare
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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.
Installa
Sezione intitolata “Installa”Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsUsa poi il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-contacts` plugin in my project.Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:
bun add @capgo/capacitor-contactsbunx cap syncImporta
Sezione intitolata “Importa”import { CapacitorContacts } from '@capgo/capacitor-contacts';Panoramica di API
Sezione intitolata “Panoramica di API”countContacts
Sezione intitolata “countContacts”Conta il numero totale di contatti sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.countContacts();createContact
Sezione intitolata “createContact”Crea un nuovo contatto in modo programmatico.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createContact({} as CreateContactOptions);createGroup
Sezione intitolata “createGroup”Crea un nuovo gruppo di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createGroup({} as CreateGroupOptions);deleteContactById
Sezione intitolata “deleteContactById”Elimina un contatto per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({} as DeleteContactByIdOptions);deleteGroupById
Sezione intitolata “deleteGroupById”Elimina un gruppo per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({} as DeleteGroupByIdOptions);displayContactById
Sezione intitolata “displayContactById”Visualizza un contatto utilizzando il visualizzatore di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({} as DisplayContactByIdOptions);displayCreateContact
Sezione intitolata “displayCreateContact”Visualizza l'interfaccia utente per la creazione di contatti nativa.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayCreateContact();displayUpdateContactById
Sezione intitolata “displayUpdateContactById”Visualizza l'interfaccia utente di aggiornamento dei contatti nativa per un contatto specifico.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayUpdateContactById({} as DisplayUpdateContactByIdOptions);getAccounts
Sezione intitolata “getAccounts”Ottieni tutti gli account disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getAccounts();getContactById
Sezione intitolata “getContactById”Ottieni un contatto specifico per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContactById({} as GetContactByIdOptions);getContacts
Sezione intitolata “getContacts”Ottieni tutti i contatti dal dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContacts();getGroupById
Sezione intitolata “getGroupById”Ottieni un gruppo specifico per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroupById({} as GetGroupByIdOptions);getGroups
Sezione intitolata “getGroups”Ottieni tutti i gruppi di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroups();isAvailable
Sezione intitolata “isAvailable”Verifica se i contatti sono disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isAvailable();isSupported
Sezione intitolata “isSupported”Verifica se il plugin è supportato sulla piattaforma corrente.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isSupported();openSettings
Sezione intitolata “openSettings”Apri le impostazioni dei contatti del dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.openSettings();pickContact
Sezione intitolata “pickContact”Scegli un singolo contatto utilizzando il picker di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
Sezione intitolata “pickContacts”Scegliere uno o più contatti utilizzando il picker di contatti nativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
Sezione intitolata “updateContactById”Aggiornare un contatto esistente con ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
Sezione intitolata “checkPermissions”Verificare lo stato di autorizzazione corrente per i contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
Sezione intitolata “requestPermissions”Richiedere le autorizzazioni per accedere ai contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.requestPermissions();Riferimento di tipo
Sezione intitolata “Riferimento di tipo”CountContactsResult
Sezione intitolata “Conteggio dei contatti”Risultato dal conteggio dei contatti.
export interface CountContactsResult { /** * Total number of contacts. * * @since 1.0.0 */ count: number;}CreateContactOptions
Sezione intitolata “Opzioni per la creazione di un contatto”Opzioni per la creazione di un contatto.
export interface CreateContactOptions { /** * Contact information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ contact: Omit<Contact, 'id'>;}CreateContactResult
Sezione intitolata “Risultato dalla creazione di un contatto”Risultato dalla creazione di un contatto.
export interface CreateContactResult { /** * The ID of the newly created contact. * * @since 1.0.0 */ id: string;}CreateGroupOptions
Sezione intitolata “CreateGroupOptions”Opzioni per la creazione di un gruppo.
export interface CreateGroupOptions { /** * Group information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ group: Omit<Group, 'id'>;}CreateGroupResult
Sezione intitolata “CreateGroupResult”Risultato dalla creazione di un gruppo.
export interface CreateGroupResult { /** * The ID of the newly created group. * * @since 1.0.0 */ id: string;}DeleteContactByIdOptions
Sezione intitolata “DeleteContactByIdOptions”Opzioni per la cancellazione di un contatto per ID.
export interface DeleteContactByIdOptions { /** * The ID of the contact to delete. * * @since 1.0.0 */ id: string;}DeleteGroupByIdOptions
Sezione intitolata “DeleteGroupByIdOptions”Opzioni per la cancellazione di un gruppo per ID.
export interface DeleteGroupByIdOptions { /** * The ID of the group to delete. * * @since 1.0.0 */ id: string;}DisplayContactByIdOptions
Sezione intitolata “DisplayContactByIdOptions”Opzioni per visualizzare un contatto per ID.
export interface DisplayContactByIdOptions { /** * The ID of the contact to display. * * @since 1.0.0 */ id: string;}DisplayCreateContactOptions
Sezione intitolata “DisplayCreateContactOptions”Opzioni per visualizzare l'interfaccia utente nativa per la creazione di un contatto.
export interface DisplayCreateContactOptions { /** * Optional pre-filled contact information for the create UI. * * @since 1.0.0 */ contact?: Omit<Contact, 'id'>;}DisplayCreateContactResult
Sezione intitolata “DisplayCreateContactResult”Risultato dalla visualizzazione dell'interfaccia utente nativa per la creazione di un contatto.
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
Sezione intitolata “DisplayUpdateContactByIdOptions”Opzioni per visualizzare l'interfaccia utente nativa per l'aggiornamento di un contatto.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
Sezione intitolata “GetAccountsResult”Risultato dell'ottenimento degli account.
export interface GetAccountsResult { /** * List of accounts available on the device. * * @since 1.0.0 */ accounts: Account[];}Fonte di Verità
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin. src/definitions.tsRiepilogare la sincronizzazione quando il pubblico API cambia in alto flusso.
Continua da qui: Inizia
Se stai utilizzandoInizia per pianificare dashboard e __CAPGO_KEEP_0__ operazioni, connettilo con to plan dashboard and API operations, connect it with Usando @capgo/capacitor-contacts per la capacità nativa in Usando @capgo/capacitor-contacts API Panoramica per il dettaglio di implementazione in API Panoramica Introduzione per il dettaglio di implementazione in Introduzione API Chiavi per il dettaglio di implementazione in API Chiavi, e Dispositivi per il dettaglio di implementazione in Dispositivi.