Comportamento Android

Modello di archiviazione

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

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

Regole di Scope Stabile

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

const result = await PersistentUuid.getId();

Usa uno scope 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' });

Limitazioni

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 Avvio rapido per l'utilizzo di API comportamento di iOS per le differenze del sistema operativo Apple e Utilizzo di @capgo/capacitor-persistent-uuid per una panoramica completa.