Comportamento Android

Modello di storage

Su Android, il plugin salva l'UUID in AccountManager tramite un account authenticator di proprietà del plugin. Il nome dell'account predefinito utilizza il package name dell'app come scope.

Questo permette all'UUID di persistere anche dopo una reinstallazione, laddove lo storage privato dell'app verrebbe rimosso; ciò include i cicli di disinstallazione/reinstallazione di Android Studio e le installazioni con diverse chiavi di firma (debug o Play Store), purché il package name rimanga invariato.

Regole di scope stabili

Usa lo scope predefinito quando il package name dell'app rimane stabile tra i vari build.

const result = await PersistentUuid.getId();

Usa uno scope personalizzato se le build di debug, staging e produzione usano package identifier diversi ma devono condividere lo stesso UUID persistente.

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

Limiti

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

Continua da Comportamento Android

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