Per iniziare

Installa

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa 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 questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

bun add @capgo/capacitor-persistent-uuid
bunx cap sync

Avvio rapido

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

const result = await PersistentUuid.getId();
console.log(result);

Esempio: resetId

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

const result = await PersistentUuid.resetId();
console.log(result);

Errori comuni

• Sync nativo: esegui bunx cap sync dopo gli aggiornamenti dei plugin.
• Fonte di verità: fidati src/definitions.ts nel repo GitHub.

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 salva un UUID. Le chiamate successive restituiranno lo stesso UUID per lo stesso scope.

Usa uno scope custom stabile

Lo scope nativo predefinito è il nome del package su Android e il bundle identifier su iOS. Se le build di debug e produzione usano package identifier diversi ma devono condividere lo stesso UUID, passa uno scope condiviso.

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

Resetta l'UUID

Chiama resetId quando l'utente effettua il logout, richiede un reset della privacy o quando i test automatizzati necessitano di un nuovo identificatore.

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

Aspettative sulla persistenza

• Su Android la persistenza sopravvive alla disinstallazione e reinstallazione, incluse le installazioni tramite Android Studio e Play Store con chiavi di firma diverse, purché il package name o lo scope custom siano stabili.
• iOS sopravvive agli aggiornamenti dell'app e del sistema operativo, mantenendo invariate le regole di accesso al Keychain.
• Il Web utilizza localStorage ed è solo un fallback per lo sviluppo.

Continua da Getting Started

Se stai usando Per iniziare per aggiungere un'identità persistente dell'app, collegala a @capgo/capacitor-persistent-uuid per la panoramica, Comportamento su Android per il comportamento in caso di reinstallazione, Comportamento su iOS per il comportamento del Keychain, Usando @capgo/capacitor-persistent-uuid per il tutorial, e Directory dei plugin di Capgo per altri plugin nativi.