UUID persistente

Utilizza @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

Cosa questo plugin espone

• getId - Leggi lo UUID memorizzato, creandone uno se non esiste per lo scope selezionato.
• resetId - Ruota lo UUID memorizzato per logout, reset della privacy o flussi di pulizia per test.
• scope - Nome spazio opzionale per app il cui identificatore pacchetto di debug e produzione differisce.

Esempi 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 tra varianti di build

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

console.log(result.id);

Resetta l'identificatore

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

Note sulla piattaforma

Il plugin Android memorizza l'UUID in AccountManager per sopravvivere ai cicli di reinstallazione di Android Studio e alle differenze di firma Play quando il nome del pacchetto o lo scope personalizzato è stabile. iOS memorizza l'UUID in Keychain e lo mantiene attraverso aggiornamenti di app e iOS mentre l'accesso a Keychain rimane compatibile. Web utilizza localStorage come fallback di sviluppo.

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

Riferimento Completo

• GitHub: https://github.com/Cap-go/capacitor-uuid-persistente/
• Doc: /docs/plugins/uuid-persistente/

Continua

Se stai utilizzando @capgo/capacitor-persistent-uuid per mantenere l'identità dell'app stabile, connettila con @capgo/capacitor-persistent-uuid per una panoramica Iniziare per installare e esempi di API Comportamento Android per dettagli di reinstallazione Comportamento iOS per dettagli della Keychain, e @capgo/capacitor-persistent-account quando hai bisogno di persistenza dei dati di account al posto di un UUID.