UUID persistente

Utilizzo di @capgo/capacitor-persistent-uuid

Genera un UUID persistente per Capacitor e mantienilo stabile attraverso reinstallazione e flussi di aggiornamento dove la normale memorizzazione dell'applicazione viene rimossa.

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 le app con identificatori di pacchetto di debug e produzione diversi.

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 Build Variants

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 sulle Piattaforme

L'Android memorizza l'UUID in AccountManager per poter 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, rimozione manuale dell'account, pulizia di Keychain, pulizia dello storage del browser o resetId.

Riferimento Completo

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

Continua

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