Saltare al contenuto principale
Logo Capgo
Torna ai plugin
@capgo/capacitor-uuid-persistente
Tutorial
@capgo/capacitor-uuid-persistente

UUID persistente

Genera e persisti un UUID applicativo univoco attraverso reinstallazioni, aggiornamenti dell'app e aggiornamenti del sistema operativo

Download al mese

0

GitHub Stelle

2

Guida

Tutorial sul UUID Persistente

Using @capgo/capacitor-persistent-uuid

Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.

Cos'è che questo plugin esporre

npm install @capgo/capacitor-persistent-uuid
npx cap sync

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 di test.
  • scope - Nome spazio opzionale per le app le cui identificatori dei pacchetti di debug e produzione differiscono.
  • __CAPGO_KEEP_0__

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

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

console.log(result.id);

Ripristina l'identificatore

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

Nota della piattaforma

Sul sistema Android, il UUID viene memorizzato 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. Su iOS, il UUID viene memorizzato in Keychain e rimane valido attraverso aggiornamenti dell'app e dell'iOS, fintanto che 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 manuale dell'account, pulizia di Keychain, pulizia dello storage del browser o resetId.

Riferimento completo

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 API esempi 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.