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

Contatti Plugin Capacitor

Accedi e gestisci i contatti del dispositivo con funzionalità 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

Usare @capgo/capacitor-contacts

Interfaccia del 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 l'aggiornamento di un contatto specifico.
getAccounts Recupera tutti gli account disponibili sul dispositivo.
getContactById Ottieni un contatto specifico tramite ID.
getContacts Ottieni tutti i contatti dal dispositivo.
getGroupById Ottieni un gruppo specifico tramite ID.
getGroups Ottieni 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 Using @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" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-contacts" nel tuo code.

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

Sì. Contacts è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che giri 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 è free 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 Contacts senza passare dalla 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