Saltar al contenido

Primeros pasos

GitHub

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:

Ventana de terminal
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:

Ventana de terminal
bun add @capgo/capacitor-persistent-uuid
bunx cap sync
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.getId();
console.log(result);
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.resetId();
console.log(result);
  • Sync nativo: ejecuta bunx cap sync tras actualizar los plugins.
  • Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.
import { PersistentUuid } from '@capgo/capacitor-persistent-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.

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 identificadores de paquete diferentes pero deben compartir un solo UUID, pasa un scope compartido.

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

Llama a resetId cuando el usuario cierra sesión, solicita un reinicio de privacidad o cuando las pruebas automatizadas necesitan un identificador nuevo.

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
  • Android puede sobrevivir a la desinstalación y reinstalación, incluidas las instalaciones de Android Studio y Play con claves de firma diferentes, siempre que el nombre del paquete o el scope personalizado sea estable.
  • iOS sobrevive a las actualizaciones de la app y de iOS, mientras que las reglas de acceso a Keychain permanecen iguales.
  • Web usa localStorage y es solo un fallback de desarrollo.

Si estás usando Primeros pasos para añadir una identidad persistente a la app, conéctalo con @capgo/capacitor-persistent-uuid para el resumen, Comportamiento de Android para el comportamiento al reinstalar, Comportamiento en iOS para el comportamiento de Keychain, Uso de @capgo/capacitor-persistent-uuid para el tutorial, y Directorio de plugins de Capgo para otros plugins nativos.