Avvio

Copia una promessa di installazione con i passaggi 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.

Installa

npm install @capgo/capacitor-persistent-uuid
npx cap sync

Importa

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 UUID. Le chiamate successive restituiscono lo stesso UUID per lo stesso ambito.

Usa uno scope personalizzato stabile

Il campo di default nativo è il nome del pacchetto su Android e l'identificatore della raccolta su iOS. Se le versioni di debug e produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere un UUID, passa uno scope condiviso.

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

Resetta l'UUID

Chiamare resetId quando l'utente si disconnette, richiede un reset della privacy, o quando sono necessari test automatizzati con un nuovo identificatore.

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

Aspettative di persistenza

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

Prosegui da Getting Started

Per aggiungere un'identità di app persistente, connettilo con @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid per la panoramica, @capgo/capacitor-persistent-uuid per il comportamento di reinstallazione, Comportamento iOS per il comportamento della chiave di cassetta, Utilizzando @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid per il tutorial, e Using @capgo/capacitor-persistent-uuid Per aggiungere un'identità di app persistente, connettilo con Directory dei plugin protetti da Capgo per altri plugin nativi.