Getting Started

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa 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

npm install @capgo/capacitor-persistent-uuid
npx cap sync

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 ámbito.

Usar un ámbito personalizado estable

El alcance predeterminado nativo es el nombre del paquete en Android y el identificador de la caja en iOS. Si los builds de depuración y producción utilizan identificadores de paquete diferentes pero deberían compartir un UUID, pase un alcance compartido.

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

Restablecer el UUID

Llame a resetId cuando el usuario se desloguee, solicite un reinicio 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 e instalación nuevamente, incluyendo Android Studio y Play instalar con diferentes claves de firma, cuando el nombre del paquete o el alcance personalizado sea estable.
iOS sobrevive a actualizaciones de aplicaciones e iOS actualizaciones mientras las reglas de acceso a la caja siguen siendo las mismas.
Web utiliza localStorage y es solo un fallback de desarrollo.

Siga adelante desde Getting Started

Si estás utilizando Inicio rápido para agregar identidad de aplicación persistente, conecta con @capgo/capacitor-persistent-uuid para la visión general, comportamiento de Android para el comportamiento de reinstalación, comportamiento de iOS para el comportamiento de Keychain, Usando @capgo/capacitor-persistent-uuid para el tutorial, y Capgo Directorio del plugin para otros plugins nativos.