Vai al contenuto

Comportamento Android

GitHub

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

Questo consente all'UUID di sopravvivere ai percorsi di reinstallazione comuni in cui l'archiviazione privata dell'app verrebbe rimossa, inclusi i cicli di disinstallazione/reinstallazione in Android Studio e le installazioni firmate con chiavi di debug o di firma Play diverse, a patto che il nome del pacchetto rimanga invariato.

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

const result = await PersistentUuid.getId();

Usa uno scope personalizzato quando i build di debug, staging e produzione usano identificatori di pacchetto diversi ma devono condividere un unico UUID persistente.

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

L'UUID può andare perso se l'utente rimuove l'account dalle impostazioni di Android, se il dispositivo viene ripristinato alle impostazioni di fabbrica, se il pacchetto/scope cambia o se l'app chiama resetId.

Se stai validando il comportamento di reinstallazione su Android, collega questa pagina con Per iniziare per l'uso di API, Comportamento su iOS per le differenze della piattaforma Apple, e Usando @capgo/capacitor-persistent-uuid per una guida completa.