Guida
Come usare Persistent UUID in Capacitor
Usando @capgo/capacitor-persistent-uuid
Genera un UUID persistente per Capacitor che rimanga stabile anche dopo reinstallazioni o aggiornamenti che cancellano lo storage locale dell'app.
Installa
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Cosa espone questo plugin
- getId - Legge l'UUID memorizzato, creandone uno se non esiste per lo scope selezionato.
- resetId - Ruota l'UUID memorizzato per flussi di logout, reset della privacy o pulizia dei test.
- scope - Namespace opzionale per app i cui identificativi di pacchetto debug e produzione differiscono.
Esempio d'uso
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 unico UUID tra le varianti di build
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Reimposta l'identificatore
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Note sulla piattaforma
Android memorizza l'UUID in AccountManager in modo che sopravviva ai cicli di reinstallazione di Android Studio e alle differenze di firma tra debug e Play, purché il nome del pacchetto o lo scope personalizzato rimangano stabili. iOS memorizza l'UUID in Keychain e lo mantiene attraverso gli aggiornamenti dell'app e di iOS, finché l'accesso a Keychain rimane compatibile. Web utilizza localStorage come fallback per lo sviluppo.
Questo plugin non espone un ID hardware e non sopravvive a reset di fabbrica, rimozione manuale dell'account, svuotamento del Keychain, svuotamento dello storage del browser o resetId.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs: /docs/plugins/persistent-uuid/
Continua
Se stai usando @capgo/capacitor-persistent-uuid per mantenere stabile l'identità dell'app, collegala a @capgo/capacitor-persistent-uuid per la panoramica, Per iniziare per l'installazione e gli esempi API, Comportamento su Android per i dettagli sulla reinstallazione, Comportamento su iOS per i dettagli su Keychain, e @capgo/capacitor-persistent-account quando hai bisogno di persistenza dei dati dell'account invece di un UUID.