@capgo/capacitor-persistent-uuid

Panoramica

Genera e persisti un UUID specifico dell'app tra reinstallazioni, aggiornamenti dell'app e del sistema operativo

Inizia con getId() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Funzionalità principali

• getId - Legge l'UUID memorizzato, creandone uno nuovo se non esiste per lo scope selezionato.
• resetId - Ruota l'UUID per flussi di logout, reset dell'account, reset della privacy o pulizia dei test.
• scope - Usa un namespace stabile se le build di debug e production usano package identifier diversi ma devono condividere lo stesso ID.

Storage di piattaforma

Piattaforma	Storage	Scope predefinito
Android	AccountManager di proprietà del plugin authenticator	Nome del pacchetto app
iOS	Keychain generic password, accessibile solo dal dispositivo	Bundle identifier
Web	fallback su localStorage	web

Non è un identificativo hardware. Non sopravvive al ripristino di fabbrica, alla rimozione manuale dell'account, alla cancellazione del Keychain, allo svuotamento dello storage del browser o a una chiamata esplicita a resetId.

Pubblico API

Metodo	Descrizione
getId	Legge o crea l'UUID persistente per uno scope.
resetId	Sostituisce l'UUID memorizzato per uno scope.
getPluginVersion	Restituisce l'indicatore della versione del plugin nativo.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts in capacitor-persistent-uuid.

Continua con @capgo/capacitor-persistent-uuid

Se stai usando @capgo/capacitor-persistent-uuid per identificare un'installazione dell'app nei vari flussi di reinstallazione, collegala a Per iniziare per l'installazione e l'uso, Comportamento su Android per i dettagli su AccountManager, Comportamento su iOS per i dettagli su Keychain, Usando @capgo/capacitor-persistent-uuid per il tutorial, e @capgo/capacitor-persistent-account quando devi persistere i dati dell'account invece di un identificativo.