iOS-Verhalten

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Speichermodell

Unter iOS speichert das Plugin die UUID im Keychain als generischen Passwort-Eintrag. Der Eintrag ist gerätespezifisch und nutzt die Bundle-ID als Standard-Scope.

Dies bleibt auch nach App- oder iOS-Updates erhalten. Es übersteht sogar Neuinstallationen, solange iOS den Keychain-Eintrag behält und die App über dieselbe Bundle-ID und dieselben Apple-Team-Regeln weiterhin kompatiblen Keychain-Zugriff hat.

Stabile Scope-Regeln

Nutze den Standard-Scope, wenn die Bundle-ID stabil ist.

const result = await PersistentUuid.getId();

Verwenden Sie einen benutzerdefinierten Scope, wenn mehrere Build-Varianten auf eine einzige App-ID auflösen sollen.

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

Limits

Die UUID kann verloren gehen, wenn der Nutzer das Gerät löscht, Keychain-Daten bereinigt werden, der Keychain-Zugriff sich ändert, der Bundle/Team-Zugriff wechselt oder die App resetId aufruft.

Weiter mit iOS-Verhalten

Wenn Sie die iOS-Persistenz validieren, verknüpfen Sie diese Seite mit Erste Schritte für die API Nutzung, Android-Verhalten für das Android-Reinstall-Verhalten, und @capgo/capacitor-persistent-uuid verwenden für eine vollständige Anleitung.