Testa il ripristino delle credenziali

La funzionalità Restore Credentials di Gestore delle credenziali garantisce una transizione senza problemi per gli utenti che passano a un nuovo dispositivo. Durante il test della funzionalità, puoi utilizzare uno dei seguenti approcci:

  • Dispositivi separati: utilizza un dispositivo di origine per eseguire il backup e un dispositivo di destinazione separato per eseguire il ripristino oppure utilizza due emulatori Android Studio separati.
  • Dispositivo singolo: utilizza un dispositivo fisico o un emulatore di Android Studio. Dopo che l'app ha eseguito il backup dei dati, disinstallala e reinstallala, quindi esegui il ripristino.

Questa guida descrive come utilizzare Android Studio per testare Restore Credentials per un'app abilitata al debug su un emulatore, simulando entrambe le situazioni di dispositivi separati o di un singolo dispositivo.

Prerequisiti

Per utilizzare la funzionalità di backup e ripristino di Android Studio per testare Restore Credentials, verifica i seguenti prerequisiti:

  • Android Studio Otter | 2025.2.1 o versioni successive.
  • Un dispositivo virtuale o fisico con Android 9 (livello API 28) o versioni successive con un'immagine di sistema Google Play e Google Play Services versione 242200000 o successive (verifica con adb shell dumpsys package com.google.android.gms | grep versionCode).
  • Un Account Google che ha eseguito l'accesso sul dispositivo di test o sull'emulatore, con un blocco schermo tramite PIN, sequenza o password configurato in Impostazioni > Sicurezza in modo che la crittografia end-to-end (E2EE) sul cloud sia attiva e non venga generato l'errore E2eeUnavailableException.
  • Un'app creata con debuggable true o in esecuzione in modalità debug. Il debug è abilitato per impostazione predefinita per gli emulatori.

Utilizza la funzionalità di backup e ripristino di Android Studio

Per testare la funzionalità Restore Credentials utilizzando Android Studio, esegui prima il backup dei dati da un dispositivo, quindi ripristina i dati dell'app su un altro dispositivo. Dopo il ripristino dell'app, lo stato di autenticazione viene ripristinato automaticamente.

Esegui il backup dei dati di autenticazione in Android Studio

Per testare il flusso di backup in Android Studio, completa i seguenti passaggi:

  1. Esegui l'app sull'emulatore.
  2. Accedi all'app utilizzando un meccanismo di autenticazione (ad esempio nome utente e password, passkey o Accedi con Google) in modo che l'app chiami createCredential() con CreateRestoreCredentialRequest.
  3. Fai clic su Backup App Data (Esegui il backup dei dati dell'app) nelle opzioni del dispositivo nella parte superiore della finestra del dispositivo in esecuzione.
    Backup dei dati delle app in Android Studio
    Figura 1: Backup dei dati delle app in Android Studio
  4. In Tipo di backup, seleziona Da dispositivo a dispositivo o Cloud.

  5. Fai clic su OK.

Testa l'autenticazione ripristinata

Al termine del backup, utilizza lo stesso dispositivo per testare il passaggio di ripristino o utilizza un altro dispositivo.

Per testare il flusso di ripristino in Android Studio, completa i seguenti passaggi:

  1. Per eseguire il test con lo stesso dispositivo, disinstalla e reinstalla l'app (adb uninstall <package_name> seguito da adb install <path_to_apk>). In questo modo, vengono cancellati tutti i dati dell'app locale e la chiave di ripristino precedente sul dispositivo. Per utilizzarla su un nuovo dispositivo, installa l'app sul nuovo dispositivo.

  2. Per testare il ripristino in background di livello 1 (BackupAgent.onRestoreFinished()) senza avviare prima Activity, apri Esegui > Modifica configurazioni in Android Studio e imposta Opzioni di avvio > Avvia su Niente prima dell'installazione. Se avvii l'app prima di eseguire Ripristina i dati dell'app, vieni reindirizzato alla schermata di autenticazione perché la chiave di ripristino non è ancora stata ripristinata sul dispositivo.

  3. Fai clic su Ripristina dati dell'app nelle opzioni del dispositivo della finestra Running Devices e seleziona il backup creato di recente.

    Ripristina i dati dell'app in Android Studio
    Figura 2: ripristina i dati dell'app in Android Studio

  4. Controlla Logcat per verificare che BackupAgent.onRestoreFinished() abbia recuperato RestoreCredential in background oppure apri l'app per verificare che l'utente abbia eseguito l'accesso automaticamente.

Esegui i test con adb o suite di test JUnit 5 automatizzate

Oltre all'azione dell'interfaccia utente di Android Studio, puoi testare i flussi di backup e ripristino dalla riga di comando o nell'integrazione continua (CI):

  • Test da riga di comando con bmgr: su un dispositivo fisico o un emulatore headless, attiva il gestore dei backup (adb shell bmgr enable true), attiva un backup (adb shell bmgr backupnow <package_name>), reinstalla l'app, elenca i set di backup disponibili (adb shell bmgr list sets) e attiva un ripristino (adb shell bmgr restore <token> <package_name>). Per i dettagli completi, consulta Testare il backup e il ripristino.
  • Test host JUnit 5 automatici (androidx.test.backup): scrivi test JUnit 5 automatici utilizzando BackupRestoreController per testare sia BackupTransportMode.CLOUD_ENCRYPTED sia BackupTransportMode.DEVICE_TO_DEVICE su uno o due dispositivi connessi. Per istruzioni sulla configurazione e test di esempio, consulta Test automatici di backup e ripristino.