Vai alla sezione principale
Torna ai plugin
@capgo/capacitor-persistent-uuid
Tutorial
@capgo/capacitor-persistent-uuid

UUID persistente

Genera e persiste un UUID applicativo a livello di applicazione attraverso reinstallazioni, aggiornamenti dell'applicazione e aggiornamenti del sistema operativo

Guida

Tutorial sul UUID persistente

Utilizza @capgo/capacitor-persistent-uuid

Genera un UUID applicativo persistente per Capacitor e mantienilo stabile attraverso reinstallazioni e flussi di aggiornamento in cui la normale memorizzazione dell'applicazione viene rimossa

Installazione

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

Cosa Questo Plugin Espone

  • getId - Leggi l'UUID memorizzato, creandone uno se non esiste per lo scope selezionato.
  • resetId - Ruota l'UUID memorizzato per il logout, il reset della privacy o le flussi di pulizia dei test.
  • scope - Nome spazio opzionale per gli app i cui identificatori dei pacchetti di debug e produzione differiscono.

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);

Nota del Sito

Android memorizza l'UUID in AccountManager per poterlo 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. iOS memorizza l'UUID in Keychain e lo mantiene attraverso l'aggiornamento dell'app e dell'iOS mentre l'accesso a Keychain rimane compatibile. Web utilizza localStorage come fallback di sviluppo.

Questo plugin non espone un ID hardware e non sopravvive al reset di fabbrica, alla rimozione manuale dell'account, alla pulizia di Keychain, alla pulizia dello storage del browser o al resetId.

Riferimento Completo

Continua a procedere

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