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 abilità al tuo strumento di AI utilizzando il seguente comando:

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

Usa poi 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 del tuo platform qui sotto:

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.

Usa uno scopo personalizzato stabile

Lo scopo predefinito nativo è il nome del pacchetto su Android e l'identificatore della confezione su iOS. Se gli edifici di debug e produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere un ID UUID, passa uno scopo condiviso.

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

Reset L'ID UUID

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

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

Aspettative di persistenza

L'Android può sopravvivere all'installazione e reinstallazione, compreso 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.
Il Web utilizza localStorage e è solo un fallback di sviluppo.

Continua da Getting Started

Se stai utilizzando Inizio per aggiungere un'identità di app persistente, connettilo con @capgo/capacitor-persistent-uuid per la panoramica, Comportamento Android per il comportamento di reinstallazione, Comportamento iOS per il comportamento della Keychain, Utilizzando @capgo/capacitor-persistent-uuid per il tutorial, e Capgo Directory dei plugin per altri plugin nativi.