Getting Started

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-persistent-uuid`
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/persistent-uuid/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

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi utilizza la seguente richiesta:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-persistent-uuid` plugin in my project.

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

bun add @capgo/capacitor-persistent-uuid
bunx cap sync

Importazione

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

Leggi o Crea L'ID UUID

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const result = await PersistentUuid.getId();

console.log(result.id);
console.log(result.scope);
console.log(result.created);

La prima chiamata crea e memorizza un ID UUID. Le chiamate successive restituiscono lo stesso ID UUID per lo stesso ambito.

Utilizza uno Scopo Personalizzato Stabile

Lo scopo predefinito nativo è il nome del pacchetto su Android e l'identificatore del bundle su iOS. Se i build di debug e produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere lo stesso ID UUID, passa uno scopo condiviso.

const result = await PersistentUuid.getId({
  scope: 'com.example.app',
});

Ripristina L'ID UUID

Chiamare resetId quando l'utente si disconnette, richiede un reset della privacy o quando sono necessari identificatori nuovi per i test automatizzati.

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

Aspettative di persistenza

L'Android può sopravvivere all'installazione e reinstallazione, compresi Android Studio e installazioni Play con chiavi di firma diverse, quando il nome del pacchetto o lo scope personalizzato è stabile.
L'aggiornamento dell'app e gli aggiornamenti di iOS sopravvivono mentre le regole di accesso alla Keychain rimangono le stesse.
L'Web utilizza localStorage e è solo un fallback di sviluppo.

Continua da qui: Getting Started

Se stai utilizzando Getting Started per aggiungere identità dell'app persistente, connettilo con @capgo/capacitor-uuid persistente per la panoramica comportamento Android per il comportamento di reinstallazione comportamento iOS per il comportamento della Keychain Utilizzare @capgo/capacitor-uuid persistente per il tutorial e Capgo Directory dei plugin per altri plugin nativi