Getting Started

Copia una riga di comando 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.

Sezione intitolata “Installa”

You can use our AI-Assisted Setup to install the plugin. Add the Capgo skills to your AI tool using the following command:

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

Usa poi la seguente richiesta:

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

Se preferisci l'installazione 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'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 UUID. Le chiamate successive restituiscono lo stesso UUID per lo stesso ambito.

Usa uno Scopo Personalizzato Stabile

Lo scopo 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 un UUID, passa uno scopo condiviso.

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

Ripristina L'UUID

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

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

Aspettative di Persistenza

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

Continua da Getting Started

Se stai utilizzando Getting Started per aggiungere un'identità dell'app persistente, connettilo con @capgo/capacitor-persistent-uuid per l'overview, comportamento di Android per il comportamento di reinstallazione, comportamento di iOS per il comportamento di Keychain, Usando @capgo/capacitor-persistent-uuid per il tutorial, e Capgo Directory dei Plugin per altri plugin nativi.