Primeros pasos

Instalar

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

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

Luego usa el siguiente prompt:

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

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

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

Inicio rápido

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

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

Ejemplo: resetId

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

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

Errores comunes

• Sync nativo: ejecuta bunx cap sync tras actualizar los plugins.
• Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.

Importar

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

Leer o crear el 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 primera llamada crea y almacena un UUID. Las llamadas posteriores devuelven el mismo UUID para el mismo scope.

Usa un scope personalizado estable

El scope nativo por defecto es el nombre del paquete en Android y el bundle identifier en iOS. Si los builds de debug y producción usan distintos identificadores pero deben compartir el mismo UUID, pasa un scope compartido.

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

Resetear el UUID

Llama a resetId cuando el usuario cierre sesión, solicite un reset de privacidad o cuando los tests automatizados necesiten un nuevo identificador.

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

Expectativas de persistencia

• Android puede sobrevivir a la desinstalación y reinstalación, incluyendo instalaciones desde Android Studio o Play con distintas signing keys, siempre que el nombre del paquete o el custom scope sea estable.
• iOS sobrevive a las actualizaciones de la app y del sistema mientras las reglas de acceso al Keychain sigan siendo las mismas.
• Web utiliza localStorage y es solo un fallback para desarrollo.

Continúa desde Getting Started

Si estás usando Primeros pasos para añadir una identidad de app persistente, conéctala con @capgo/capacitor-persistent-uuid para la descripción general, Comportamiento de Android para el comportamiento de reinstalación, Comportamiento en iOS para el comportamiento de Keychain, Uso de @capgo/capacitor-persistent-uuid para este tutorial, y Directorio de plugins de Capgo para otros plugins nativos.