Inizia
Copia un prompt di configurazione con le istruzioni 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”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 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”Otteni tutte le account disponibili sul dispositivo.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getAccounts();getContactById
Sezione intitolata “getContactById”Otteni 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”Controlla 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 sul dispositivo 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”Seleziona un singolo contatto utilizzando il picker dei contatti nativi.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
Sezione intitolata “pickContacts”Seleziona uno o più contatti utilizzando il picker dei contatti nativi.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
Sottosezione intitolata “aggiornaContattoPerId”Aggiorna un contatto esistente per ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
Sottosezione intitolata “verificaAutorizzazioni”Verifica lo stato di autorizzazione corrente per i contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
Sottosezione intitolata “richiediAutorizzazioni”Richiedi le autorizzazioni per accedere ai contatti.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.requestPermissions();Riferimento di tipo
Sottosezione intitolata “Riferimento di tipo”CountContactsResult
Sezione intitolata “CountContactsResult”Risultato dalla 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 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 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 per creare un contatto”Opzioni per visualizzare l'interfaccia utente nativa per creare 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 “Visualizza risultato per creare un contatto”Risultato dalla visualizzazione dell'interfaccia utente nativa per creare 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 “Visualizza opzioni per aggiornare un contatto”Opzioni per visualizzare l'interfaccia utente nativa per aggiornare un contatto.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
Sezione intitolata “Risultato per ottenere le account”Risultato dall'ottenimento 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 sviluppo.
Continua da qui: Iniziare
Sezione intitolata “Continua da qui: Iniziare”Se stai utilizzando Iniziare per pianificare dashboard e API operazioni, connettilo con Utilizzando @capgo/capacitor-contacts per la capacità nativa in Utilizzando @capgo/capacitor-contacts, API Overview 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.