Guida
Come utilizzare UUID persistente in Capacitor
Utilizzo di @capgo/capacitor-uuid-persistente
Genera un UUID persistente per Capacitor e mantienilo stabile attraverso reinstall e flussi di aggiornamento dove la normale memorizzazione dell'applicazione viene rimossa.
Installa
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Cos'è questo Plugin
- getId - Leggi lo UUID memorizzato, creandone uno se non esiste per lo scope selezionato.
- resetId - Rota lo UUID memorizzato per i flussi di logout, reset della privacy o pulizia dei test.
- Scopo - Nome spazio facoltativo per le app con identificatori 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 per le Piattaforme
L'Android memorizza lo UUID in AccountManager, quindi può 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 lo UUID in Keychain e lo mantiene attraverso l'aggiornamento 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 degli account, pulizia di Keychain, pulizia dello storage del browser o resetId.
Riferimento Completo
- GitHub: https://github.com/Cap-go/capacitor-uuid-persistente/
- Documentazione: /docs/plugins/uuid-persistente/
Continua
Se stai utilizzando @capgo/capacitor-uuid-persistente per mantenere stabile l'identità dell'app, connettilo con @capgo/capacitor-uuid-persistente per l'overview Guida per l'Inizio per l'installazione e gli esempi di API Comportamento Android per i dettagli della reinstallazione, Comportamento iOS per i dettagli della Keychain, e @capgo/capacitor-account persistente quando hai bisogno di persistenza dei dati di account invece di un UUID.