xref: /aosp_15_r20/frameworks/base/tests/LegacyRestoreTest/README (revision d57664e9bc4670b3ecf6748a746a57c557b6bc9e)
1*d57664e9SAndroid Build Coastguard WorkerThe file "jbmr2-encrypted-settings-abcd.ab" in this directory is an encrypted
2*d57664e9SAndroid Build Coastguard Worker"adb backup" archive of the settings provider package.  It was generated on a
3*d57664e9SAndroid Build Coastguard WorkerNexus 4 running Android 4.3 (API 18), and so predates the Android 4.4 changes
4*d57664e9SAndroid Build Coastguard Workerto the PBKDF2 implementation.  The archive's encryption password, entered on-screen,
5*d57664e9SAndroid Build Coastguard Workeris "abcd" (with no quotation marks).
6*d57664e9SAndroid Build Coastguard Worker
7*d57664e9SAndroid Build Coastguard Worker'adb restore' decrypts and applies the restored archive successfully on a device
8*d57664e9SAndroid Build Coastguard Workerrunning Android 4.3, but fails to restore correctly on a device running Android 4.4,
9*d57664e9SAndroid Build Coastguard Workerreporting an invalid password in logcat.  This is the situation reported in bug
10*d57664e9SAndroid Build Coastguard Worker<https://code.google.com/p/android/issues/detail?id=63880>.
11*d57664e9SAndroid Build Coastguard Worker
12*d57664e9SAndroid Build Coastguard WorkerThe file "kk-fixed-encrypted-settings-abcd.ab" is a similar encrypted "adb backup"
13*d57664e9SAndroid Build Coastguard Workerarchive, using the same key, generated on a Nexus 4 running Android 4.4 with a fix
14*d57664e9SAndroid Build Coastguard Workerto this bug in place.  This archive should be successfully restorable on any
15*d57664e9SAndroid Build Coastguard Workerversion of Android which incorporates the fix.
16*d57664e9SAndroid Build Coastguard Worker
17*d57664e9SAndroid Build Coastguard WorkerThese archives can be used as an ongoing test to verify that historical encrypted
18*d57664e9SAndroid Build Coastguard Workerarchives from various points in Android's history can be successfully restored.
19