如需各程式庫版本的完整異動清單，請參閱 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 服務略過應用程式，或需要更新才能還原，還原作業就會失敗，並顯示錯誤訊息說明原因。詳情請參閱「排解還原失敗問題」。
- 修正錯誤並提升穩定性。
如要使用這個版本，請在測試套件中將 backupTestLibraryVersion 設為 "1.0.0-alpha03"。
1.0.0-alpha02
2026 年 10 月 7 日
修正錯誤，並改善與 AGP 測試套件的整合。
1.0.0-alpha01
2026 年 9 月 23 日
自動備份和還原測試程式庫 androidx.test.backup:backup 和 androidx.test.backup:backup-host 的初始版本。