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.

Installa

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

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

Poi utilizza 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 un ambito personalizzato stabile

Lo scope 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 UUID, passa uno scope 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 necessarie identificatori automatici per test.

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 la panoramica, 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 del Plugin per altri plugin nativi.