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

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter, và 76 phần khác.

AdbStopServerPreparer	Trình chuẩn bị mục tiêu để dừng máy chủ adb trên máy chủ trước và sau khi chạy kiểm thử adb.
AllTestAppsInstallSetup	`ITargetPreparer` cài đặt tất cả ứng dụng từ thư mục `IDeviceBuildInfo.getTestsDir()` vào thiết bị.
AoaTargetPreparer	`ITargetPreparer` thực thi một loạt thao tác (ví dụ: lượt nhấp và vuốt) bằng giao thức Phụ kiện mở Android (AOAv2).
AppSetup	`ITargetPreparer` cài đặt tệp apk và các bài kiểm thử của tệp apk đó.
ArtChrootPreparer	Tạo thư mục chroot cho các bài kiểm thử ART.
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.
CheckPairingPreparer	`CompanionAwarePreparer` xác minh tính năng liên kết BT giữa thiết bị chính và thiết bị đồng hành
CompanionAllocator	Lớp cơ sở giúp phân bổ và giải phóng thiết bị đồng hành Bạn nên triển khai `getCompanionDeviceSelectionOptions()` để mô tả các tiêu chí cần thiết để phân bổ thiết bị đồng hành
CompanionAwarePreparer	`ITargetPreparer` đóng gói logic để lấy thiết bị đồng hành đã được phân bổ.
CompanionRunCommandTargetPreparer	`ITargetPreparer` chạy các lệnh được chỉ định trên thiết bị đồng hành được phân bổ
CompanionTestAppInstallSetup	`ITargetPreparer` cài đặt một hoặc nhiều ứng dụng từ thư mục `IDeviceBuildInfo.getTestsDir()` vào một thiết bị đồng hành được phân bổ.
CompileBootImageWithSpeedTargetPreparer	Biên dịch lại đường dẫn lớp khởi động và máy chủ hệ thống bằng bộ lọc trình biên dịch "speed" (tốc độ).
CpuThrottlingWaiter	`ITargetPreparer` đợi cho đến khi tần suất tối đa trên tất cả các lõi được khôi phục về cấp cao nhất có sẵn
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.
DeviceActionTargetPreparer	`ITargetPreparer` để thực hiện các thao tác trên thiết bị.
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à tuỳ ý 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 trên thiết bị bằng hình ảnh thiết bị được cung cấp qua một định dạng cụ thể.
DeviceOwnerTargetPreparer	`ITargetPreparer` thiết lập thành phần chủ sở hữu thiết bị.
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.
DeviceStorageFiller	Trình chuẩn bị mục tiêu để lấp đầy bộ nhớ để có một lượng dung lượng trống.
DeviceStringPusher	Trình chuẩn bị mục tiêu để ghi một chuỗi vào tệ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).
DeviceWiper	`ITargetPreparer` xoá dữ liệu người dùng
DisableSELinuxTargetPreparer	Trình chuẩn bị mục tiêu tắt SELinux nếu được bật.
DynamicSystemPreparer	`ITargetPreparer` thiết lập hình ảnh hệ thống trên một bản dựng thiết bị bằng Bản cập nhật hệ thống động.
EraseUserDataPreparer	`ITargetPreparer` xoá dữ liệu người dùng trên thiết bị.
FastbootCommandPreparer	Trình chuẩn bị mục tiêu kích hoạt tính năng khởi động nhanh và gửi lệnh khởi động nhanh.
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ả.
FeatureFlagTargetPreparer	Cập nhật DeviceConfig (cờ tính năng do dịch vụ từ xa điều chỉnh).
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ị.
FolderSaver	`ITargetPreparer` kéo các thư mục ra khỏi thiết bị, nén và lưu vào phần phụ trợ ghi nhật ký.
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 trên thiết bị bằng hình ảnh hệ thống chung của Android.
ILabPreparer	Giao diện điểm đánh dấu cho người chuẩn bị phòng thí nghiệm Hãy xem `ITargetPreparer` để biết nội dung mô tả về mục đích của các giao diện này.
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ở.
InstallAllTestZipAppsSetup	`ITargetPreparer` cài đặt tất cả ứng dụng trong tệp zip kiểm thử.
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer` cài đặt một hoặc nhiều tệp APK nằm trên hệ thống tệp.
InstallBuildEnvApkSetup	`ITargetPreparer` cài đặt một hoặc nhiều tệp APK kiểm thử từ môi trường bản dựng nền tảng Android.
InstallKernelModulePreparer	Trình chuẩn bị mục tiêu cài đặt các mô-đun hạt nhân.
InstrumentationPreparer	`ITargetPreparer` chạy công cụ đo lường
KillExistingEmulatorPreparer	`ITargetPreparer` tắt trình mô phỏng đang chạy.
KnownFailurePreparer	Trình chuẩn bị mục tiêu để bỏ qua việc thử lại lỗi đã biết.
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
MixKernelTargetPreparer	`ITargetPreparer` cho phép kết hợp hình ảnh hạt nhân với hình ảnh thiết bị.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` chạy lệnh "dumpsys meminfo --unreachable -a" để xác định bộ nhớ gốc không thể truy cập hiện đang được mỗi quy trình giữ.
NoApkTestSkipper	Trình chuẩn bị đặc biệt cho phép bỏ qua hoàn toàn một lệnh gọi (chuẩn bị và kiểm thử) nếu không có tệp APK nào để kiểm thử.
PerfettoPreparer	Trình chuẩn bị Perfetto đẩy tệp cấu hình vào thiết bị ở một vị trí tiêu chuẩn mà Perfetto có quyền truy cập.
ProfileTargetPreparer	Lớp cơ sở để thiết lập trình chuẩn bị mục tiêu cho mọi người dùng hồ sơ `android.os.usertype.profile.XXX`.
PushFileInvoker	Lớp này không còn được dùng nữa. Thay vào đó, hãy sử dụng `PushFilePreparer`
PushFilePreparer	`ITargetPreparer` cố gắng đẩy số lượng tệp bất kỳ từ đường dẫn máy chủ bất kỳ đến đường dẫn thiết bị bất kỳ.
PythonVirtualenvPreparer	Thiết lập virtualenv Python trên máy chủ lưu trữ và cài đặt các gói.
RebootTargetPreparer	Trình chuẩn bị mục tiêu khởi động lại thiết bị.
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.
Xoá SystemAppPreparer	`ITargetPreparer` để xoá tệp apk khỏi phân vùng hệ thống trước khi chạy kiểm thử.
RestartSystemServerTargetPreparer	Trình chuẩn bị mục tiêu khởi động lại máy chủ hệ thống mà không cần khởi động lại thiết bị.
RootTargetPreparer	Trình chuẩn bị mục tiêu thực hiện "adb root" hoặc "adb unroot" dựa trên tuỳ chọn "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Trình chuẩn bị mục tiêu để chạy các lệnh tuỳ ý của máy chủ trước và sau khi chạy chương trình kiểm thử.
RunHostScriptTargetPreparer	Trình chuẩn bị mục tiêu thực thi một tập lệnh trước khi chạy kiểm thử.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` để đánh dấu rằng các chương trình kiểm thử sẽ chạy trong hộp cát sdk.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` để đảm bảo rằng kiểm thử chạy dưới dạng người dùng phụ.
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 đó.
SemaphoreTokenTargetPreparer	Đây là trình chuẩn bị dùng để sử dụng mã thông báo nhằm chuyển đổi tuần tự quá trình thực thi kiểm thử trong máy chủ tradefed.
SideloadOtaTargetPreparer	Trình chuẩn bị mục tiêu thực hiện tải không qua cửa hàng ứng dụng của một gói OTA được chỉ định, áp dụng gói, đợi thiết bị khởi động và chèn các thuộc tính bản dựng thiết bị để sử dụng làm thông tin bản dựng Trình chuẩn bị mục tiêu này giả định rằng thiết bị sẽ ở chế độ adb thông thường khi khởi động và sẽ đảm bảo rằng thiết bị thoát ở cùng chế độ nhưng áp dụng bản dựng mới hơn.
StopServicesSetup	`ITargetPreparer` dừng các dịch vụ trên thiết bị.
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.
SwitchUserTargetPreparer	`ITargetPreparer` chuyển sang loại người dùng được chỉ định trong setUp.
TearDownPassThroughPreparer	Cho phép chạy tearDown trên trình chuẩn bị có trong cấu hình dưới dạng một đối tượng.
TemperatureThrottlingWaiter	`ITargetPreparer` sẽ chờ cho đến khi nhiệt độ của thiết bị giảm xuống mức mục tiêu
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ị.
TestFilePushSetup	`ITargetPreparer` đẩy một hoặc nhiều tệp/thư mục từ thư mục `IDeviceBuildInfo.getTestsDir()` vào thiết bị.
TestSystemAppInstallSetup	`ITargetPreparer` cài đặt một hoặc nhiều ứng dụng từ thư mục `IDeviceBuildInfo.getTestsDir()` vào phân vùng /system trên thiết bị.
TimeWaster	Một trình chuẩn bị mục tiêu đơn giản để lãng phí thời gian và có thể khởi động lại thiết bị.
UserCleaner	`ITargetPreparer` xoá người dùng phụ khi gỡ bỏ.
VisibleBackgroundUserPreparer	Trình chuẩn bị mục tiêu để chạy kiểm thử trong một người dùng được bắt đầu ở chế độ hiển thị trong nền.
WaitForDeviceDatetimePreparer	`ITargetPreparer` chờ đặt ngày giờ trên thiết bị Trình chuẩn bị này có thể buộc `TargetSetupError` nếu bạn không đặt ngày giờ trong thời gian chờ.
WifiPreparer	`ITargetPreparer` định cấu hình wifi trên thiết bị nếu cần.

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. Thay vào đó, hãy sử dụng `setUp(com.android.tradefed.invoker.TestInformation)`
`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. Thay vào đó, hãy sử dụng `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

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