Inizia
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.
Installazione
Sottosezione intitolata “Installazione”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-pluginsPoi utilizza 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 la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo sistema operativo qui sotto:
bun add @capgo/capacitor-contactsbunx cap syncImporta
Sezione intitolata “Importa”import { CapacitorContacts } from '@capgo/capacitor-contacts';API Panoramica
Sezione intitolata “API Panoramica”countContacts
Sezione intitolata “countContacts”Contare il numero totale di contatti sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.countContacts();createContact
Sezione intitolata “createContact”Creare un nuovo contatto in modo programmatico.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createContact({} as CreateContactOptions);createGroup
Sottosezione intitolata “createGroup”Creare un nuovo gruppo di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createGroup({} as CreateGroupOptions);deleteContactById
Sottosezione intitolata “deleteContactById”Cancella un contatto per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({} as DeleteContactByIdOptions);deleteGroupById
Sottosezione intitolata “deleteGroupById”Cancella un gruppo per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({} as DeleteGroupByIdOptions);displayContactById
Sottosezione 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 nativa per la creazione di un contatto.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayCreateContact();displayUpdateContactById
Sezione intitolata “displayUpdateContactById”Visualizza l'interfaccia utente nativa per l'aggiornamento di 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 tramite ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContactById({} as GetContactByIdOptions);getContacts
Sezione intitolata “getContacts”Ottenere tutti i contatti dal dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContacts();getGroupById
Sezione intitolata “getGroupById”Ottenere un gruppo specifico tramite ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroupById({} as GetGroupByIdOptions);getGroups
Sezione intitolata “getGroups”Ottenere tutti i gruppi di contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroups();isAvailable
Sezione intitolata “isAvailable”Verificare se i contatti sono disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isAvailable();isSupported
Sottosezione intitolata “isSupported”Controlla se il plugin è supportato sul corrente sistema operativo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isSupported();openSettings
Sottosezione intitolata “openSettings”Apre le impostazioni dei contatti del dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.openSettings();pickContact
Sottosezione intitolata “pickContact”Seleziona un singolo contatto utilizzando il picker dei contatti nativi.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
Sottosezione intitolata “pickContacts”Seleziona uno o più contatti utilizzando il picker dei contatti nativi.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
Sezione intitolata “aggiornaContattoPerId”Aggiorna un contatto esistente con ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
Sezione intitolata “controllaAutorizzazioni”Verifica lo stato di autorizzazione corrente per i contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
Sezione intitolata “richiediAutorizzazioni”Richiedi 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 “CountContactsResult”Risultato della conta dei contatti.
export interface CountContactsResult { /** * Total number of contacts. * * @since 1.0.0 */ count: number;}CreateContactOptions
Sezione intitolata “CreateContactOptions”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 “CreateContactResult”Risultato della 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 eliminare 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 eliminare 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 “Visualizza opzioni di creazione di contatto”Opzioni per visualizzare l'interfaccia di creazione di contatto nativa.
export interface DisplayCreateContactOptions { /** * Optional pre-filled contact information for the create UI. * * @since 1.0.0 */ contact?: Omit<Contact, 'id'>;}DisplayCreateContactResult
Sezione intitolata “Visualizza risultato di creazione di contatto”Risultato dalla visualizzazione dell'interfaccia di creazione di contatto nativa.
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 “Visualizza opzioni di aggiornamento di contatto per ID”Opzioni per visualizzare l'interfaccia di aggiornamento di contatto nativa.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
Sezione intitolata “Risultato di recupero delle account”Risultato dal recupero delle 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’s src/definitions.ts. Riavvia la sincronizzazione quando le informazioni pubbliche API cambiano in fase di aggiornamento.
Continua da qui: Iniziare
Sezione intitolata “Continua da qui: Iniziare”Se stai utilizzando Iniziare per pianificare dashboard e API operazioni, connettilo con Utilizza @capgo/capacitor-contacts per la capacità nativa in Utilizza @capgo/capacitor-contacts, Panoramica di API per i dettagli di implementazione in API Panoramica Introduzione per i dettagli di implementazione in Introduzione API Chiavi per i dettagli di implementazione in API Chiavi, e Dispositivi per i dettagli di implementazione in Dispositivi.