Saltare al contenuto

Comportamento Android

GitHub

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

Questa consente all'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 pacchetto rimane lo stesso.

Utilizza l'ambito predefinito quando il nome pacchetto dell'applicazione è stabile tra le build.

const result = await PersistentUuid.getId();

Utilizza un ambito personalizzato quando le build di debug, di staging e di produzione utilizzano identificatori di pacchetto diversi ma dovrebbero condividere un UUID persistente.

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

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

Inizia per l'uso di __CAPGO_KEEP_0__ for API usage, per le differenze del platform Apple, e Usando @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid Using @capgo/capacitor-persistent-uuid per una panoramica completa.