Comportamento di iOS

Modello di archiviazione

Su iOS, il plugin memorizza l'UUID nel Keychain come un elemento di password generico. L'elemento è dispositivo unico e utilizza l'identificatore del pacchetto come ambito predefinito.

Questo sopravvive agli aggiornamenti dell'app e agli aggiornamenti di iOS. Sopravvive anche ai flussi di reinstallazione, purché iOS mantenga l'elemento del Keychain e l'app mantenga l'accesso al Keychain compatibile attraverso lo stesso pacchetto e le stesse regole di Apple.

Regole di ambito stabile

Utilizzare l'ambito predefinito quando l'identificatore del pacchetto è stabile.

const result = await PersistentUuid.getId();

Utilizzare un ambito personalizzato quando più varianti di build dovrebbero risolvere in un identificatore dell'app.

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

Limiti

Il UUID può essere perso se l'utente cancella il dispositivo, i dati di Keychain vengono cancellati, cambia l'accesso a Keychain, cambia l'accesso al bundle/team, o l'app chiama resetId.

Continua da iOS Behavior

Inizia per l'uso di __CAPGO_KEEP_0__ for API usage, per il comportamento di reinstallazione Android, e Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid Using @capgo/capacitor-persistent-uuid per una guida completa.