备份和恢复测试版本说明

如需查看每个库版本中的完整变更列表,请参阅 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 的初始版本。