Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses 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.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

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

Quickstart

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

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

Beispiel: resetId

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

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

Häufige Stolperfallen

Nativer Sync: ausführen bunx cap sync nach Plugin-Upgrades.
Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Importieren

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

UUID lesen oder erstellen

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

const result = await PersistentUuid.getId();

console.log(result.id);
console.log(result.scope);
console.log(result.created);

Der erste Aufruf erstellt und speichert eine UUID. Spätere Aufrufe geben dieselbe UUID für denselben Scope zurück.

Einen stabilen Custom Scope nutzen

Der native Standard-Scope ist der Package-Name unter Android und die Bundle-ID unter iOS. Wenn Debug- und Production-Builds unterschiedliche Package-IDs nutzen, aber dieselbe UUID teilen sollen, übergeben Sie einen gemeinsamen Scope.

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

UUID zurücksetzen

Rufen Sie resetId auf, wenn sich der User ausloggt, einen Privacy-Reset anfordert oder wenn automatisierte Tests eine neue ID benötigen.

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

Erwartungen an die Persistenz

Unter Android bleibt die ID auch nach Deinstallation und Neuinstallation erhalten – selbst bei Android Studio oder Play Store Instanzen mit unterschiedlichen Signing Keys –, sofern der Package-Name oder Custom Scope stabil bleibt.
Unter iOS bleibt die ID bei App-Updates und iOS-Updates erhalten, solange die Keychain-Zugriffsregeln unverändert sind.
Web nutzt localStorage und dient lediglich als Fallback für die Entwicklung.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte Um eine persistente App-Identität hinzuzufügen, verbinde sie mit @capgo/capacitor-persistent-uuid für die Übersicht, Android-Verhalten für das Verhalten bei Neuinstallationen, iOS-Verhalten für das Keychain-Verhalten, @capgo/capacitor-persistent-uuid verwenden für das Tutorial, und Capgo Plugin-Verzeichnis für andere native Plugins.