Iniziare

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

È possibile 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

Lo scope predefinito nativo è il nome del pacchetto su Android e l'identificatore del bundle su iOS. Se le versioni 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'iOS utilizza localStorage e è solo un fallback di sviluppo.

Continua da qui dal Getting Started

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