Saltare al contenuto principale
Torna ai plugin
@capgo/capacitor-persistent-uuid
Istruzioni
@capgo/capacitor-persistent-uuid

UUID persistente

Genera e persisti un UUID applicativo univoco attraverso reinstallazioni, aggiornamenti dell'app e aggiornamenti del sistema

Guida

Tutoriale su UUID persistente

Utilizzare @capgo/capacitor-uuid-persistente

Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.

Installa

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

Cos'è che questo plugin esporre

  • getId - Leggi lo UUID memorizzato, creandone uno se non esiste per lo scope selezionato.
  • resetId - Rotare l'UUID memorizzato per il logout, il reset della privacy o le flussi di pulizia dei test.
  • scope - Nome spazio opzionale per le app le cui identificatori dei pacchetti di debug e di produzione differiscono.

Esempio di utilizzo

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

const { id, created, scope } = await PersistentUuid.getId();

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

Condividi un'UUID Across le varianti di build

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

console.log(result.id);

Ripristina L'Identificatore

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

Note sulla piattaforma

L'Android memorizza l'UUID in AccountManager, in modo che possa sopravvivere ai cicli di reinstallazione di Android Studio e alle differenze tra debug e Play quando il nome del pacchetto o lo scope personalizzato è stabile. L'iOS memorizza l'UUID in Keychain e lo mantiene attraverso aggiornamenti dell'app e dell'iOS, mentre l'accesso a Keychain rimane compatibile. La Web utilizza localStorage come fallback di sviluppo.

Questo plugin non esporre un ID hardware e non sopravvive a un reset di fabbrica, la rimozione manuale degli account, la pulizia di Keychain, la pulizia dello storage del browser o resetId.

Riferimento completo

Continua

Se stai utilizzando @capgo/capacitor-persistent-uuid per mantenere stabile l'identità dell'app, connettilo con @capgo/capacitor-persistent-uuid per una panoramica Getting Started for install and API examples, @__CAPGO_KEEP_0__ Comportamento Android per i dettagli della reinstallazione Comportamento iOS per i dettagli della Keychain @capgo/capacitor-account-persistente quando hai bisogno di persistenza dei dati di account al posto di un UUID.