Zum Starten

GitHub

Ein Einrichtungsvorschlag mit den Installationsanweisungen und der vollständigen Markdown-Guide für diesen Plugin kopieren.

        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

Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

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

Verwenden Sie dann den folgenden Prompt:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

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

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);

Die erste Anfrage erstellt und speichert eine UUID. Spätere Anfragen geben für denselben Bereich die gleiche UUID zurück.

Verwende einen stabilen benutzerdefinierten Bereich

Der native Standardbereich ist der Paketname auf Android und der Bundle-Identifier auf iOS. Wenn Debug- und Produktionsbuilds unterschiedliche Paket-Identifikatoren verwenden, aber eine UUID teilen sollten, übergeben Sie einen gemeinsamen Bereich.

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

UUID zurücksetzen

Rufen Sie resetId auf, wenn der Benutzer sich abmeldet, eine Datenschutzrücksetzung anfordert oder wenn automatisierte Tests einen neuen Identifikator benötigen.

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

Persistenzerwartungen

Android kann über den Entfernen und erneuten Installieren, einschließlich Android Studio und Play-Installations mit verschiedenen Signierungschlüsseln, überleben, wenn der Paketname oder der benutzerdefinierte Bereich stabil ist.
iOS überlebt App-Updates und iOS-Updates, während die Regeln für den Zugriff auf den Schlüsselbeleg gleich bleiben.
Web verwendet localStorage und ist nur ein Entwicklungsfall zurück.

Weitermachen von Getting Started

Wenn Sie Einstieg um eine persistente App-Identität hinzuzufügen, mit ihr zu verbinden @capgo/capacitor-persistent-uuid für die Übersicht, Android-Verhalten für das Wiederinstallationsverhalten, iOS-Verhalten für das Keychain-Verhalten, Mit @capgo/capacitor-persistent-uuid für die Anleitung und Capgo Plugin-Verzeichnis für andere native Plugins.