Kiểm thử tự động chức năng khôi phục dữ liệu sao lưu

Bản cập nhật mới nhất	Bản phát hành ổn định	Bản phát hành dùng thử	Bản phát hành beta	Bản phát hành alpha
Ngày 23 tháng 9 năm 2026	-	-	-	1.0.0-alpha01

Phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Trình theo dõi sự cố để biết thêm thông tin.

Kiểm thử tự động chức năng khôi phục dữ liệu sao lưu phiên bản 1.0

Phiên bản 1.0.0-alpha01

Ngày 23 tháng 9 năm 2026

Phát hành androidx.test.backup:backup:1.0.0-alpha01 và androidx.test.backup:backup-host:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Các tính năng của bản phát hành ban đầu

Bản phát hành ban đầu của Khung kiểm thử tự động sao lưu và khôi phục cho Android. Thư viện này cung cấp một cách tự động, toàn diện để kiểm thử rằng dữ liệu người dùng và thông tin đăng nhập tài khoản vẫn an toàn sau khi nâng cấp thiết bị và khôi phục từ đám mây. Thay vì dựa vào kiểm thử thủ công, nhà phát triển có thể tự động hoá toàn bộ vòng đời: gieo trạng thái ứng dụng, sao lưu trạng thái đó theo các quy tắc bạn đã định cấu hình (dataExtractionRules và fullBackupContent), xoá ứng dụng và xác minh tính toàn vẹn của dữ liệu sau khi khôi phục. Khung này cung cấp 2 cấu phần phần mềm: androidx.test.backup:backup-host (chạy trên máy chủ lưu trữ để điều phối các lượt sao lưu, xoá và khôi phục qua ADB) và androidx.test.backup:backup (chạy trên thiết bị để điền và xác minh dữ liệu ứng dụng).

• BackupRestoreController: Giao diện chính phía máy chủ dùng để kiểm soát quy trình sao lưu, xoá dữ liệu, khôi phục và xác minh cho một thiết bị thử nghiệm. Cung cấp các quy trình thuận tiện như runBackupRestoreFlow cũng như các thao tác chi tiết (performBackup, performRestore, clearAppData, fetchDeviceLogs và runOnDevice). Hỗ trợ cả coroutine Kotlin và quá trình thực thi không đồng bộ ListenableFuture của Java.
• BackupRestoreExtension: Một tiện ích JUnit 5 Jupiter giúp phân giải và chèn các tham số BackupRestoreController vào các phương thức kiểm thử. Quản lý các phiên ADB độc lập hoặc dùng chung, tự động cài đặt các APK đã kiểm thử và kiểm thử, loại bỏ màn hình khoá và khoá bảo vệ thiết bị để mở khoá bộ nhớ được bảo vệ bằng thông tin đăng nhập, đồng thời thực thi chế độ cách ly hộp cát kiểm thử.
• BackupRestoreTestRunner: Một trình chạy kiểm thử Instrumentation trên thiết bị thực thi bên trong hộp cát ứng dụng. Động giải quyết và thực thi các triển khai BackupDeviceAction được yêu cầu do các trình điều phối máy chủ gửi đi và chuyển hướng an toàn các tải trọng kết quả JSON lớn sang ổ đĩa để ngăn chặn các giới hạn bộ đệm giao dịch Trình liên kết.
• BackupDeviceAction: Hợp đồng cho các thao tác tuỳ chỉnh phía thiết bị thực thi trực tiếp trong hộp cát ứng dụng đích trong quá trình gieo dữ liệu (PHASE_POPULATE) hoặc xác thực sau khi khôi phục (PHASE_VERIFY).
• StorageDomain: Các bộ mô tả được nhập mạnh (Preference, Database, TextFile và BinaryFile) được dùng cùng với các trình trợ giúp hành động dựng sẵn (PopulateStorageAction và AssertStorageAction) để tự động gieo và xác nhận SharedPreferences, cơ sở dữ liệu SQLite và tệp thô trên cả ngữ cảnh lưu trữ được Bảo vệ bằng thông tin đăng nhập (CE) và Bảo vệ bằng thiết bị (DE) mà không cần mã nguyên mẫu.
• BackupTransportMode: Chỉ định cấu trúc liên kết truyền dữ liệu sao lưu của nền tảng để mô phỏng trong các lần kiểm thử, bao gồm DEVICE_TO_DEVICE (di chuyển thiết bị thực qua USB hoặc Wi-Fi Direct), CLOUD_ENCRYPTED (sao lưu trên đám mây bằng tính năng mã hoá hai đầu phía máy khách), CLOUD_UNENCRYPTED (sao lưu tiêu chuẩn trên đám mây) và LOCAL (sao lưu hệ thống tệp cục bộ khi không có mạng).
• @Device và @Isolation: Chú thích máy chủ để chọn các thiết bị được kết nối khớp với số sê-ri, cấp độ API hoặc vai trò nhiều thiết bị cụ thể, đồng thời định cấu hình các chính sách cách ly hộp cát giữa các lần chạy thử (IsolationPolicy.AUTOMATIC so với IsolationPolicy.MANUAL).