Primeros pasos
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este 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.
Instalar
Sección titulada “Instalación”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-pluginsLuego 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-uuidbunx cap syncInicio rápido
Sección titulada “Inicio rápido”import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.getId();console.log(result);Ejemplo: resetId
Sección titulada “Ejemplo: resetId”import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.resetId();console.log(result);Errores comunes
Sección titulada “Errores comunes”- Sync nativo: ejecuta
bunx cap synctras actualizar los plugins. - Fuente de verdad: confianza
src/definitions.tsen el repo de GitHub.
Importar
Sección titulada “Importar”import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';Leer o crear el UUID
Sección titulada «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.
Usar un scope personalizado estable
Sección titulada “Usar 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 identificadores de paquete diferentes pero deben compartir un solo UUID, pasa un scope compartido.
const result = await PersistentUuid.getId({ scope: 'com.example.app',});Restablecer el UUID
Sección titulada “Reiniciar el UUID”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);Expectativas de persistencia
Sección titulada “Expectativas de persistencia”- 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.
Continúa desde Getting Started
Sección titulada “Continúa desde Primeros pasos”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.