Salta al contenuto principale
@capgo/capacitor-contacts API dei dispositivi Open source

Contatti Plugin Capacitor

Accedi e gestisci i contatti del dispositivo con permessi di lettura e scrittura

Installa

bun add @capgo/capacitor-contacts bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-contacts
  • pnpm add @capgo/capacitor-contacts
  • yarn add @capgo/capacitor-contacts

Guida

Come usare i contatti in Capacitor

Utilizzo di @capgo/capacitor-contacts

Plugin Capacitor Contacts per gestire i contatti del dispositivo.

Installa

bun add @capgo/capacitor-contacts
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

import { CapacitorContacts } from '@capgo/capacitor-contacts';

API in breve

Metodo Descrizione
countContacts Conta il numero totale di contatti sul dispositivo.
createContact Crea un nuovo contatto via codice.
createGroup Crea un nuovo gruppo di contatti.
deleteContactById Elimina un contatto tramite ID.
deleteGroupById Elimina un gruppo tramite ID.
displayContactById Visualizza un contatto con il viewer nativo.
displayCreateContact Mostra l'interfaccia nativa per creare un contatto.
displayUpdateContactById Mostra l'interfaccia nativa per aggiornare un contatto specifico.
getAccounts Recupera tutti gli account disponibili sul dispositivo.
getContactById Recupera un contatto specifico tramite ID.
getContacts Recupera tutti i contatti dal dispositivo.
getGroupById Recupera un gruppo specifico tramite ID.
getGroups Recupera tutti i gruppi di contatti.
isAvailable Verifica se i contatti sono disponibili sul dispositivo.
isSupported Verifica se il plugin è supportato sulla piattaforma corrente.
openSettings Apri le impostazioni dei contatti del dispositivo.
pickContact Seleziona un singolo contatto tramite il picker nativo.
pickContacts Seleziona uno o più contatti tramite il contact picker nativo.
updateContactById Aggiorna un contatto esistente tramite ID.
checkPermissions Controlla lo stato attuale dei permessi per i contatti.
requestPermissions Richiedi i permessi per accedere ai contatti.

Esempi

countContacts()

Conta il numero totale di contatti sul dispositivo.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.countContacts();
console.log(result);

createContact()

Crea un nuovo contatto via codice.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.createContact({ contact: {} });
console.log(result);

createGroup()

Crea un nuovo gruppo di contatti.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

const result = await CapacitorContacts.createGroup({ group: { name: 'example' } });
console.log(result);

deleteContactById()

Elimina un contatto tramite ID.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.deleteContactById({ id: 'id-123' });

deleteGroupById()

Elimina un gruppo tramite ID.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.deleteGroupById({ id: 'id-123' });

displayContactById()

Visualizza un contatto con il viewer nativo.

import { CapacitorContacts } from '@capgo/capacitor-contacts';

await CapacitorContacts.displayContactById({ id: 'id-123' });

La tabella sopra elenca i 21 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati in repository GitHub.

Riferimento completo

Continua da Usare @capgo/capacitor-contacts

Se stai usando Usare @capgo/capacitor-contacts per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-contacts per i dettagli di implementazione in @capgo/capacitor-contacts, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.

FAQ

FAQ sul plugin Contacts

Come installo il plugin Contacts in un'app Capacitor?

Esegui "bun add @capgo/capacitor-contacts" (o "npm install @capgo/capacitor-contacts"), poi lancia "bunx cap sync" per far sì che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-contacts" nella tua app code.

@capgo/capacitor-contacts funziona con React, Vue e Angular?

Sì. Contacts è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor è supportata da @capgo/capacitor-contacts?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-contacts è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-contacts/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa i Contatti senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a Contacts senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo