Comportamento di Android

Modello di archiviazione

Su Android, il plugin memorizza l'UUID nel AccountManager sotto un account autenticatore di proprietà del plugin. Il nome account predefinito utilizza il nome del pacchetto dell'applicazione come ambito.

This consente alla UUID di sopravvivere ai percorsi di reinstallazione comuni dove lo storage privato dell'applicazione sarebbe stato rimosso, inclusi cicli di reinstallazione di Android Studio e installazioni firmate con chiavi di debug o di Play diverse quando il nome del pacchetto rimane lo stesso.

Regole di ambito stabile

Usa lo scopo predefinito quando il nome del pacchetto dell'applicazione è stabile tra le build.

const result = await PersistentUuid.getId();

Usa uno scopo personalizzato quando le build di debug, di staging e di produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere una UUID persistente.

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

Limiti

La UUID può essere persa se l'utente rimuove l'account dalle impostazioni di Android, il dispositivo viene resettato di fabbrica, il pacchetto/scopo cambia o l'app chiama resetId.

Continua da Android Behavior

Se stai validando il comportamento di reinstallazione di Android, collega questa pagina a Iniziare per l'uso di API comportamento di iOS per le differenze del platform Apple, e Utilizzando @capgo/capacitor-persistent-uuid per una guida completa.