Avvio

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-persistent-uuid`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/persistent-uuid/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installazione

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi utilizza il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-persistent-uuid` plugin in my project.

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

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

Importa

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

Leggi o crea l'ID UUID

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const result = await PersistentUuid.getId();

console.log(result.id);
console.log(result.scope);
console.log(result.created);

La prima chiamata crea e memorizza un ID UUID. Le chiamate successive restituiscono lo stesso ID UUID per lo stesso ambito.

Utilizza uno scope personalizzato stabile

L'ambito predefinito nativo è il nome del pacchetto su Android e l'identificatore del bundle su iOS. Se gli edifici di debug e produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere lo stesso ID UUID, passa uno scope condiviso.

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

Riprista L'ID Unico

Chiamare resetId quando l'utente si disconnette, richiede un reset della privacy, o quando sono necessari test automatizzati per un nuovo identificatore.

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

Aspettative di persistenza

L'Android può sopravvivere all'installazione e reinstallazione, compresi Android Studio e installazioni Play con chiavi di firma diverse, quando il nome del pacchetto o lo scope personalizzato è stabile.
L'iOS sopravvive agli aggiornamenti dell'app e agli aggiornamenti iOS mentre le regole di accesso alla Keychain rimangono le stesse.
L'Web utilizza localStorage e è solo un fallback di sviluppo.

Continua da qui da Iniziare

Se stai utilizzando Avvio per aggiungere un'identità di app persistente, connettilo con @capgo/capacitor-uuid-persistente per una panoramica Comportamento Android per il comportamento di reinstallazione Comportamento iOS per il comportamento della chiave di accesso Utilizzo di @capgo/capacitor-uuid-persistente per il tutorial, e Capgo Directory dei plugin per altri plugin nativi.