Saltare al contenuto principale
@capgo/capacitor-contatti API di dispositivo Sorgente aperta

Contatti Plugin Capacitor

Accedi e gestisci i contatti del dispositivo con capacità 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 utilizzare i Contatti in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il codice QR code.

Collegamento QR anteprima code Contatti

Utilizza @capgo/capacitor-contacts

Capacitor Plugin per la gestione dei contatti del dispositivo.

Installa

bun add @capgo/capacitor-contacts
bunx cap sync

bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

Vedi API in un colpo d'occhio

Metodo Descrizione
countContacts Conta il numero totale di contatti sul dispositivo.
createContact Creare un nuovo contatto in modo programmatico.
createGroup Creare un nuovo gruppo di contatti.
deleteContactById Cancella un contatto per ID.
deleteGroupById Cancella un gruppo per ID.
displayContactById Visualizza un contatto utilizzando il visualizzatore di contatti nativo.
displayCreateContact Display the native create contact UI.
displayUpdateContactById Visualizza l'interfaccia utente nativa per l'aggiornamento di un contatto specifico.
getAccounts Ottieni tutti gli account disponibili sul dispositivo.
getContactById Ottieni un contatto specifico per ID.
getContacts Ottieni tutti i contatti dal dispositivo.
getGroupById Ottieni un gruppo specifico per ID.
getGroups Ottieni tutti i gruppi di contatti.
isAvailable Controlla se i contatti sono disponibili sul dispositivo.
isSupported Controlla se il plugin è supportato sulla piattaforma corrente.
openSettings Apre le impostazioni dei contatti del dispositivo.
pickContact Scegli un singolo contatto utilizzando il picker di contatti nativo.
pickContacts Scegli uno o più contatti utilizzando il picker di contatti nativo.
updateContactById Aggiorna un contatto esistente per ID.
checkPermissions Controlla lo stato di permesso corrente per i contatti.
requestPermissions Richiedi i permessi per accedere ai contatti.

Esempi

countContacts()

Conta il totale di contatti sul dispositivo.

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

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

createContact()

Creare un nuovo contatto in modo programmatico.

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

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

createGroup()

Creare un nuovo gruppo di contatti.

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

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

deleteContactById()

Cancellare un contatto per ID.

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

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

deleteGroupById()

Cancellare un gruppo per ID.

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

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

displayContactById()

Visualizzare un contatto utilizzando il visualizzatore di contatti nativo.

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

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

Il tabella sopra elenca le 21 metodi di base. I listener e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository GitHub.

Riferimento completo

Continua da qui: Usando @capgo/capacitor-contacts

If sei stai utilizzando Utilizzando @capgo/capacitor-contacts per pianificare il dashboard e le operazioni di API, connettilo con @capgo/capacitor-contacts per i dettagli di implementazione in @capgo/capacitor-contacts, Getting Started per i dettagli di implementazione in Avvio, Panoramica di API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in API Chiavi.

FAQ

FAQ del plugin Contacts

How installo il plugin di Contacts in un'app Capacitor?

Run "bun add @capgo/capacitor-contacts" (o "npm install @capgo/capacitor-contacts"), poi run "bunx cap sync" affinché i progetti iOS e Android recuperino le native code. Importalo da "@capgo/capacitor-contacts" nella tua app code.

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

Sì. Il plugin di Contacts è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

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

Il plugin Capgo segue la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

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

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-contacts/ e il pacchetto è gratuito da installare su npm. I segnalazioni di bug e le richieste di pull sono benvenuti.

Posso aggiornare code che utilizza Contacts senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica le native code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con Capgo live updates.

Consegui le modifiche dei contatti senza aspettare la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo le aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS ai tuoi utenti in pochi minuti.

Inizia con Capgo