Getting Started
Einen Setup-Befehl mit den Installations-Schritten und der vollständigen Markdown-Anleitung für diesen Plugin kopieren.
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.
Installieren
Installationsabschnittbun add @capgo/capacitor-contactsbunx cap syncImportieren
Sektion mit dem Titel „Import“import { CapacitorContacts } from '@capgo/capacitor-contacts';API Übersicht
Sektion mit dem Titel „API Übersicht“countContacts
Sektion mit dem Titel „countContacts“Die Gesamtzahl der auf dem Gerät gespeicherten Kontaktinformationen ermitteln.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.countContacts();createContact
Sektion mit dem Titel „createContact“Ein neuer Kontakt programmatisch erstellen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createContact({} as CreateContactOptions);createGroup
Sektion mit dem Titel „createGroup“Ein neues Kontaktgruppen-Objekt erstellen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.createGroup({} as CreateGroupOptions);deleteContactById
Abschnitt mit dem Titel “deleteContactById”Ein Kontakt durch ID löschen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteContactById({} as DeleteContactByIdOptions);deleteGroupById
Abschnitt mit dem Titel “deleteGroupById”Ein Gruppe durch ID löschen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.deleteGroupById({} as DeleteGroupByIdOptions);displayContactById
Abschnitt mit dem Titel “displayContactById”Ein Kontakt mit der native Kontaktansicht anzeigen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayContactById({} as DisplayContactByIdOptions);displayCreateContact
Abschnitt mit dem Titel “displayCreateContact”Die native Kontakt erstellen UI anzeigen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayCreateContact();displayUpdateContactById
Abschnitt mit dem Titel „displayUpdateContactById“Zeigt die native Benachrichtigung für die Aktualisierung eines bestimmten Kontakts an.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.displayUpdateContactById({} as DisplayUpdateContactByIdOptions);getAccounts
Abschnitt mit dem Titel „getAccounts“Alle auf dem Gerät verfügbaren Konten abrufen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getAccounts();getContactById
Abschnitt mit dem Titel „getContactById“Abrufen eines bestimmten Kontakts nach ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContactById({} as GetContactByIdOptions);getContacts
Abschnitt mit dem Titel „getContacts“Abrufen aller Kontakte vom Gerät.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getContacts();getGroupById
Abschnitt mit dem Titel „getGroupById“Ein bestimmtes Gruppen-Objekt nach der ID abrufen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroupById({} as GetGroupByIdOptions);getGroups
Abschnitt mit dem Titel „getGroups“Alle Kontaktgruppen abrufen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.getGroups();isAvailable
Abschnitt mit dem Titel „isAvailable“Überprüfen, ob Kontakte auf dem Gerät verfügbar sind.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isAvailable();isSupported
Abschnitt mit dem Titel „isSupported“Überprüfen, ob der Plugin auf der aktuellen Plattform unterstützt wird.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.isSupported();openSettings
Abschnitt mit dem Titel “Einstellungen öffnen”Öffnen Sie die Einstellungen für die Gerätekontakte.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.openSettings();pickContact
Abschnitt mit dem Titel “Kontakt auswählen”Wählen Sie einen einzelnen Kontakt mit dem nativen Kontaktpicker aus.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContact();pickContacts
Abschnitt mit dem Titel “Kontakte auswählen”Wählen Sie einen oder mehrere Kontakte mit dem nativen Kontaktpicker aus.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.pickContacts();updateContactById
Abschnitt mit dem Titel “Kontakt aktualisieren”Aktualisieren Sie einen bestehenden Kontakt durch ID.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.updateContactById({} as UpdateContactByIdOptions);checkPermissions
Abschnitt mit dem Titel “checkPermissions”Überprüfen Sie den aktuellen Berechtigungsstatus für Kontakte.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.checkPermissions();requestPermissions
Abschnitt mit dem Titel “requestPermissions”Berechtigungen anfordern, um auf Kontakte zuzugreifen.
import { CapacitorContacts } from '@capgo/capacitor-contacts';
await CapacitorContacts.requestPermissions();Typenverweis
Abschnitt mit dem Titel “Typenverweis”CountContactsResult
Abschnitt mit dem Titel “CountContactsResult”Ergbnis der Kontaktaufzählung.
export interface CountContactsResult { /** * Total number of contacts. * * @since 1.0.0 */ count: number;}CreateContactOptions
Abschnitt mit dem Titel “ErstellkontaktOptionen”Optionen für die Erstellung eines Kontakts.
export interface CreateContactOptions { /** * Contact information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ contact: Omit<Contact, 'id'>;}CreateContactResult
Abschnitt mit dem Titel “ErstellkontaktErgbnis”Ergbnis der Erstellung eines Kontakts.
export interface CreateContactResult { /** * The ID of the newly created contact. * * @since 1.0.0 */ id: string;}CreateGroupOptions
Abschnitt mit dem Titel “ErstelleGruppenOptionen”Optionen für die Erstellung einer Gruppe.
export interface CreateGroupOptions { /** * Group information to create. The 'id' field will be generated automatically. * * @since 1.0.0 */ group: Omit<Group, 'id'>;}CreateGroupResult
Abschnitt mit dem Titel “ErstelleGruppenErgbnis”Ergbnis der Erstellung einer Gruppe.
export interface CreateGroupResult { /** * The ID of the newly created group. * * @since 1.0.0 */ id: string;}DeleteContactByIdOptions
Abschnitt mit dem Titel “DeleteContactByIdOptions”Optionen zum Löschen eines Kontakts durch ID.
export interface DeleteContactByIdOptions { /** * The ID of the contact to delete. * * @since 1.0.0 */ id: string;}DeleteGroupByIdOptions
Abschnitt mit dem Titel “DeleteGroupByIdOptions”Optionen zum Löschen einer Gruppe durch ID.
export interface DeleteGroupByIdOptions { /** * The ID of the group to delete. * * @since 1.0.0 */ id: string;}DisplayContactByIdOptions
Abschnitt mit dem Titel “DisplayContactByIdOptions”Optionen zum Anzeigen eines Kontakts durch ID.
export interface DisplayContactByIdOptions { /** * The ID of the contact to display. * * @since 1.0.0 */ id: string;}DisplayCreateContactOptions
Abschnitt mit dem Titel “DisplayCreateContactOptions”Optionen zum Anzeigen der native UI zum Erstellen eines Kontakts.
export interface DisplayCreateContactOptions { /** * Optional pre-filled contact information for the create UI. * * @since 1.0.0 */ contact?: Omit<Contact, 'id'>;}DisplayCreateContactResult
Abschnitt mit dem Titel “DisplayCreateContactResult”Erfolgsmeldung nach Anzeige der nativen UI für die Erstellung von Kontaktinformationen.
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
Abschnitt mit dem Titel “DisplayUpdateContactByIdOptions”Optionen für die Anzeige der nativen UI für die Aktualisierung von Kontaktinformationen.
export interface DisplayUpdateContactByIdOptions { /** * The ID of the contact to update. * * @since 1.0.0 */ id: string;}GetAccountsResult
Abschnitt mit dem Titel “GetAccountsResult”Erfolgsmeldung nach Abrufen von Konten.
export interface GetAccountsResult { /** * List of accounts available on the device. * * @since 1.0.0 */ accounts: Account[];}Quelle der Wahrheit
Abschnitt mit dem Titel “Source Of Truth”Diese Seite wurde von der Plugin-Quelle generiert. src/definitions.ts. Re-run die Synchronisation, wenn die öffentliche API sich upstream ändert.
Weiter von Getting Started
Abschnitt mit dem Titel “Weiter von Getting Started”Wenn Sie " Getting Started um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit Mit @capgo/capacitor-contacts für die native Fähigkeit in Mit @capgo/capacitor-contacts, API Übersicht für die Implementierungsdetails in API Übersicht, Einführung für die Implementierungsdetails in Einführung, API Schlüssel für die Implementierungsdetails in API Schlüssel, und Geräte für die Implementierungsdetails in Geräte.