Anmeldedaten für den Test der Wiederherstellung

Die Funktion Anmeldedaten-Wiederherstellung im Credential Manager sorgt für einen reibungslosen Übergang für Nutzer, die auf ein neues Gerät wechseln. Beim Testen der Funktion können Sie einen der folgenden Ansätze verwenden:

  • Separate Geräte: Verwenden Sie ein Quellgerät für die Sicherung und ein separates Zielgerät für die Wiederherstellung oder verwenden Sie zwei separate Android Studio-Emulatoren.
  • Einzelnes Gerät: Verwenden Sie ein physisches Gerät oder einen Android Studio-Emulator. Nachdem die App ihre Daten gesichert hat, deinstallieren Sie die App und installieren Sie sie neu. Führen Sie dann die Wiederherstellung durch.

In diesem Leitfaden wird beschrieben, wie Sie mit Android Studio Anmeldedaten für die Wiederherstellung für eine debugfähige App auf einem Emulator testen können. Dabei werden sowohl separate Geräte als auch ein einzelnes Gerät simuliert.

Vorbereitung

Wenn Sie die Funktion „Sichern und wiederherstellen“ von Android Studio zum Testen von Restore Credentials verwenden möchten, müssen die folgenden Voraussetzungen erfüllt sein:

  • Android Studio Otter | 2025.2.1 oder höher.
  • Ein virtuelles Gerät oder ein physisches Gerät mit Android 9 (API-Level 28) oder höher mit einem Google Play-System-Image und der Google Play-Dienste-Version 242200000 oder höher (mit adb shell dumpsys package com.google.android.gms | grep versionCode prüfen).
  • Ein Google-Konto, das auf dem Testgerät oder Emulator angemeldet ist, mit einer PIN, einem Muster oder einem Passwort für die Displaysperre, die unter Einstellungen > Sicherheit konfiguriert ist, damit die Ende-zu-Ende-Verschlüsselung (E2EE) in der Cloud aktiv ist und E2eeUnavailableException nicht ausgelöst wird.
  • Eine App, die mit debuggable true erstellt wurde oder im debug-Modus ausgeführt wird. Das Debugging ist für Emulatoren standardmäßig aktiviert.

Funktion „Sichern und wiederherstellen“ von Android Studio verwenden

Wenn Sie die Funktion „Anmeldedaten wiederherstellen“ mit Android Studio testen möchten, sichern Sie zuerst die Daten von einem Gerät und stellen Sie dann die App-Daten auf einem anderen Gerät wieder her. Nach der Wiederherstellung der App wird der Authentifizierungsstatus automatisch wiederhergestellt.

Authentifizierungsdaten in Android Studio sichern

So testen Sie den Sicherungsablauf in Android Studio:

  1. Führen Sie die App im Emulator aus.
  2. Melden Sie sich mit einem beliebigen Authentifizierungsmechanismus in der App an (z. B. Nutzername und Passwort, Passkeys oder „Über Google anmelden“), damit Ihre App createCredential() mit CreateRestoreCredentialRequest aufruft.
  3. Klicken Sie oben im Fenster des aktiven Geräts in den Geräteoptionen auf App-Daten sichern.
    App-Daten in Android Studio sichern
    Abbildung 1: App-Daten in Android Studio sichern
  4. Wählen Sie als Sicherungstyp die Option Gerät-zu-Gerät oder Cloud aus.

  5. Klicken Sie auf OK.

Wiederhergestellte Authentifizierung testen

Nachdem die Sicherung abgeschlossen ist, können Sie entweder dasselbe Gerät verwenden, um den Wiederherstellungsschritt zu testen, oder ein anderes Gerät.

So testen Sie den Wiederherstellungsvorgang in Android Studio:

  1. Wenn du mit demselben Gerät testen möchtest, deinstalliere die App und installiere sie neu (adb uninstall <package_name> gefolgt von adb install <path_to_apk>). Dadurch werden alle lokalen App-Daten und der vorherige Wiederherstellungsschlüssel auf dem Gerät gelöscht. Wenn Sie die App auf einem neuen Gerät verwenden möchten, installieren Sie sie auf dem neuen Gerät.

  2. Wenn Sie die Hintergrundwiederherstellung der Stufe 1 (BackupAgent.onRestoreFinished()) testen möchten, ohne zuerst die Activity zu starten, öffnen Sie in Android Studio Ausführen > Konfigurationen bearbeiten und setzen Sie vor der Installation Startoptionen > Starten auf Nichts. Wenn Sie die App starten, bevor Sie App-Daten wiederherstellen ausführen, werden Sie zum Authentifizierungsbildschirm weitergeleitet, da der Wiederherstellungsschlüssel noch nicht auf dem Gerät wiederhergestellt wurde.

  3. Klicken Sie in den Geräteoptionen des Fensters „Running Device“ auf Restore App Data und wählen Sie die kürzlich erstellte Sicherung aus.

    App-Daten in Android Studio wiederherstellen
    Abbildung 2: App-Daten in Android Studio wiederherstellen

  4. Prüfen Sie Logcat, um zu bestätigen, dass BackupAgent.onRestoreFinished() die RestoreCredential im Hintergrund abgerufen hat, oder öffnen Sie die App, um zu prüfen, ob der Nutzer automatisch angemeldet wird.

Mit adb oder automatisierten JUnit 5-Test-Suites testen

Zusätzlich zur UI-Aktion von Android Studio können Sie Sicherungs- und Wiederherstellungsabläufe über die Befehlszeile oder in der Continuous Integration (CI) testen:

  • Befehlszeilentests mit bmgr: Aktiviere auf einem physischen Gerät oder einem Headless-Emulator den Sicherungsmanager (adb shell bmgr enable true), löse eine Sicherung aus (adb shell bmgr backupnow <package_name>), installiere die App neu, liste die verfügbaren Sicherungssätze auf (adb shell bmgr list sets) und löse eine Wiederherstellung aus (adb shell bmgr restore <token> <package_name>). Weitere Informationen findest du unter Sicherung und Wiederherstellung testen.
  • Automatisierte JUnit 5-Hosttests (androidx.test.backup): Schreiben Sie automatisierte JUnit 5-Tests mit BackupRestoreController, um sowohl BackupTransportMode.CLOUD_ENCRYPTED als auch BackupTransportMode.DEVICE_TO_DEVICE auf einem oder zwei verbundenen Geräten zu testen. Eine Einrichtungsanleitung und Beispieltests finden Sie unter Automatisierte Sicherungs- und Wiederherstellungstests.