Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Các lớp con gián tiếp đã biết

BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CreateAvdPreparer, CreateUserPreparer, DeviceBuildInfoBootStrapper, DeviceBuildInfoInjector, DeviceCleaner, DeviceFlashPreparer, DeviceImageZipFlashingTargetPreparer, DeviceSetup, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, FoldableModePreparer, GkiDeviceFlashPreparer, và 15 phần khác.

BaseEmulatorPreparer	Trình chuẩn bị phổ biến để chạy trình mô phỏng cục bộ.
BaseTargetPreparer	Lớp triển khai cơ sở cho `ITargetPreparer` cho phép kiểm soát việc đối tượng có bị tắt hay không.
BuildInfoRecorder	`ITargetPreparer` ghi siêu dữ liệu thông tin bản dựng vào một tệp đã chỉ định.
CreateAvdPreparer
CreateUserPreparer	Trình chuẩn bị mục tiêu để tạo người dùng và dọn dẹp người dùng đó khi kết thúc.
DeviceBuildInfoBootStrapper	`ITargetPreparer` thay thế các trường thông tin bản dựng bằng các thuộc tính được đọc từ thiết bị Điều này rất hữu ích khi kiểm thử các thiết bị có bản dựng được tạo từ một nguồn bên ngoài (ví dụ:
DeviceBuildInfoInjector	`ITargetPreparer` chèn siêu dữ liệu `DeviceBuildDescriptor` vào `IBuildInfo`.
DeviceCleaner	Thực hiện khởi động lại hoặc định dạng dưới dạng thao tác dọn dẹp sau khi kiểm thử và có thể tắt màn hình
DeviceFlashPreparer	`ITargetPreparer` cài đặt ROM hình ảnh trên phần cứng Android thực.
DeviceImageZipFlashingTargetPreparer	Trình chuẩn bị mục tiêu cài đặt ROM cho thiết bị bằng hình ảnh thiết bị được cung cấp qua một định dạng cụ thể.
DeviceSetup	`ITargetPreparer` định cấu hình một thiết bị để kiểm thử dựa trên các `Option` được cung cấp.
DeviceUpdateTargetPreparer	`ITargetPreparer` trừu tượng xử lý các bước phổ biến liên quan đến việc cập nhật thiết bị bằng tệp hình ảnh thiết bị từ một nguồn bên ngoài (thay vì dịch vụ bản dựng).
FastbootUpdateBootstrapPreparer	`ITargetPreparer` phân chia các tệp đã chỉ định (trình tải khởi động, đài, tệp ZIP hình ảnh thiết bị) vào `IDeviceBuildInfo` để cài đặt ROM cho thiết bị bằng `FastbootDeviceFlasher`, sau đó chèn các thuộc tính thiết bị sau khi khởi động vào thông tin bản dựng cho mục đích báo cáo kết quả.
FoldableModePreparer	Trình chuẩn bị mục tiêu có thể chuyển đổi trạng thái có thể gập lại của thiết bị.
GkiDeviceFlashPreparer	Trình chuẩn bị mục tiêu sẽ cài đặt ROM cho thiết bị bằng hình ảnh chung của nhân Android.
GsiDeviceFlashPreparer	Trình chuẩn bị mục tiêu cài đặt ROM cho thiết bị bằng hình ảnh hệ thống chung của Android.
ITargetCleaner	Giao diện này không còn được dùng nữa. tearDown đã được chuyển sang giao diện ITargetPreparer cơ sở.
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	`ITargetPreparer` tắt trình mô phỏng đang chạy.
LocalEmulatorLaunch	TargetPreparer chạy trình mô phỏng cục bộ từ môi trường xây dựng Android.
LocalEmulatorSnapshot	TargetPreparer dùng để tạo ảnh chụp nhanh trình mô phỏng sạch từ môi trường phát triển/bản dựng Android
ModuleOemTargetPreparer
RecoveryLogPreparer	Trình chuẩn bị mục tiêu dùng để thu thập nhật ký trước khi khôi phục.
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` tạo một người dùng phụ trong quá trình thiết lập và đánh dấu rằng các chương trình kiểm thử sẽ chạy trong người dùng đó.
RunOnSystemUserTargetPreparer	`ITargetPreparer` đánh dấu rằng các chương trình kiểm thử sẽ chạy trên người dùng (thay vì người dùng hiện tại).
RunOnWorkProfileTargetPreparer	`ITargetPreparer` tạo hồ sơ công việc trong quá trình thiết lập và đánh dấu rằng các kiểm thử sẽ chạy trong người dùng đó.
StubTargetPreparer	Phương thức triển khai phần giữ chỗ trống của `ITargetPreparer`.
SuiteApkInstaller	Cài đặt các APK được chỉ định cho cấu hình Suite: từ biến $ANDROID_TARGET_OUT_TESTCASES hoặc ROOT_DIR trong thông tin bản dựng.
TestAppInstallSetup	`ITargetPreparer` cài đặt một hoặc nhiều ứng dụng từ thư mục `IDeviceBuildInfo.getTestsDir()` vào thiết bị.

Chuẩn bị môi trường kiểm thử cho lần chạy kiểm thử.

Ví dụ: cài đặt phần mềm, điều chỉnh chế độ cài đặt môi trường để kiểm thử, chạy mục tiêu, v.v.

Xin lưu ý rằng bạn có thể chỉ định nhiều ITargetPreparer trong một cấu hình. Bạn nên ghi lại rõ ràng từng ITargetPreparer về môi trường dự kiến trước và sau khi thiết lập. Ví dụ: ITargetPreparer định cấu hình một thiết bị để kiểm thử phải được chạy sau khi ITargetPreparer cài đặt phần mềm.

Tóm tắt

Phương thức công khai
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Phương thức này không còn được dùng nữa. Sử dụng `setUp(com.android.tradefed.invoker.TestInformation)` thay thế
`default void`	`setUp(TestInformation testInformation)` Thực hiện thiết lập mục tiêu để kiểm thử.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Thực hiện việc dọn dẹp/gỡ bỏ mục tiêu sau khi kiểm thử.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Phương thức này không còn được dùng nữa. Sử dụng `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)` thay thế

Phương thức công khai

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Phương thức này không còn được dùng nữa.
Hãy sử dụng setUp(com.android.tradefed.invoker.TestInformation)

Thực hiện thiết lập mục tiêu để kiểm thử.

Tham số
`device`	`ITestDevice`: `ITestDevice` cần chuẩn bị.
`buildInfo`	`IBuildInfo`: dữ liệu về bản dựng đang được kiểm thử.

Gửi
`TargetSetupError`	nếu xảy ra lỗi nghiêm trọng khi thiết lập môi trường
`BuildError`	Nếu xảy ra lỗi liên quan đến BuildInfo
`DeviceNotAvailableException`	nếu thiết bị không phản hồi

setUp

public void setUp (TestInformation testInformation)

Thực hiện thiết lập mục tiêu để kiểm thử.

Tham số
`testInformation`	`TestInformation`: `TestInformation` của lệnh gọi.

Gửi
`TargetSetupError`	nếu xảy ra lỗi nghiêm trọng khi thiết lập môi trường
`BuildError`	Nếu xảy ra lỗi do bản dựng đang được chuẩn bị
`DeviceNotAvailableException`	nếu thiết bị không phản hồi

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Thực hiện việc dọn dẹp/gỡ bỏ mục tiêu sau khi kiểm thử.

Tham số
`testInformation`	`TestInformation`: `TestInformation` của lệnh gọi.
`e`	`Throwable`: nếu lệnh gọi kết thúc bằng một ngoại lệ, thì đây sẽ là ngoại lệ được phát hiện ở cấp Lệnh gọi. Nếu không, sẽ là `null`.

Gửi
`DeviceNotAvailableException`	nếu thiết bị không phản hồi

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Phương thức này không còn được dùng nữa.
Hãy sử dụng tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Thực hiện việc dọn dẹp/gỡ bỏ mục tiêu sau khi kiểm thử.

Tham số
`device`	`ITestDevice`: `ITestDevice` cần chuẩn bị.
`buildInfo`	`IBuildInfo`: dữ liệu về bản dựng đang được kiểm thử.
`e`	`Throwable`: nếu lệnh gọi kết thúc bằng một ngoại lệ, thì đây sẽ là ngoại lệ được phát hiện ở cấp Lệnh gọi. Nếu không, sẽ là `null`.

Gửi
`DeviceNotAvailableException`	nếu thiết bị không phản hồi