Vai al contenuto

@capgo/capacitor-persistent-uuid

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

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.

PiattaformaSupportoNote
iOSSìNativo
AndroidSìNativo
WebNoProteggi con Capacitor.getPlatform()
  • getId - Legge l'UUID memorizzato, creandone uno 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 quando le build di debug e produzione utilizzano identificatori di pacchetto diversi ma devono condividere un unico identificatore.
PiattaformaArchiviazioneScope predefinito
AndroidAccount AccountManager di proprietà dell'autenticatore del pluginNome del pacchetto app
iOSPassword generica Keychain, accessibilità solo dispositivoIdentificativo del bundle
Webfallback su localStorageweb

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.

MetodoDescrizione
getIdLegge o crea l'UUID persistente per uno scope.
resetIdSostituisce l'UUID memorizzato per uno scope.
getPluginVersionRestituisce l'indicatore della versione del plugin nativo.

Questo riferimento è sincronizzato da src/definitions.ts in 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.