如需查看每个库版本中的完整变更列表,请参阅 androidx.test.backup 版本说明。
1.0.0-alpha04
2026 年 11 月 4 日
- 为
runBackupRestoreFlow添加了StorageDomain类型:DataStorePreference用于 Preferences DataStore,CustomData用于自定义设备操作,ExcludedData用于检查是否未恢复排除的数据。如需了解详情,请参阅内置存储类型。 - 向内置
StorageDomain类型添加了isDeviceProtectedStorage,以测试设备保护的存储空间。向StorageDomain.Preference添加了Set<String>值支持。 - 向
runBackupRestoreFlow添加了restoreOn,用于在设备之间传输;向BackupRestoreController添加了uninstallApp;向@Device添加了minApi和maxApi边界。如需了解详情,请参阅选择设备。 - 添加了
BackupActionResult.data和BackupActionResult.getOrThrow,用于读取设备操作返回的数据,并在操作失败时失败。 - 更新了
BackupRestoreExtension,以便在测试失败时保存每个设备的 logcat,并在失败输出中列出文件路径。如需关闭日志保存功能,请传递-Dandroidx.test.backup.device.logs.enabled=false。如需了解详情,请参阅检查测试报告。 - 已向
InstrumentationRegistry注册BackupRestoreTestRunner,以便设备操作可以调用getInstrumentation。向@BackupRestoreConfig添加了可选的testApplicationId值,并将applicationId设为可选。 - 移除了
BackupDeviceAction.phase、PHASE_POPULATE、PHASE_VERIFY和BackupRestoreExtension(AdbSession)构造函数。从自定义设备操作中移除override val phase。
如需使用此版本,请在测试套件中将 backupTestLibraryVersion 设置为 "1.0.0-alpha04"。
1.0.0-alpha03
2026 年 10 月 21 日
- 备份测试套件中的测试会针对该套件所针对的应用变体运行,因此不再需要
@BackupRestoreConfig。 - 您可以使用
androidx.test.backup.device.serial.{role}系统属性将@Device角色绑定到设备。如需了解详情,请参阅选择设备。 - 当 Google Play 服务跳过您的应用或需要更新才能恢复应用时,恢复会失败,并显示一条出错提示,说明原因。如需了解详情,请参阅排查恢复失败问题。
- 修复了一些 bug 并提升了可靠性。
如需使用此版本,请在测试套件中将 backupTestLibraryVersion 设置为 "1.0.0-alpha03"。
1.0.0-alpha02
2026 年 10 月 7 日
修复了多项 bug,并改进了与 AGP 测试套件的集成。
1.0.0-alpha01
2026 年 9 月 23 日
自动备份和恢复测试库 androidx.test.backup:backup 和 androidx.test.backup:backup-host 的初始版本。