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à 79 mục khác.

AdbStopServerPreparer	Trình chuẩn bị mục tiêu để dừng máy chủ adb trên máy chủ lưu trữ trước và sau khi chạy các kiểm thử adb.
AllTestAppsInstallSetup	Một `ITargetPreparer` cài đặt tất cả ứng dụng từ mộ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ụ: nhấp và vuốt) bằng giao thức Phụ kiện mở Android (AOAv2).
AppSetup	Một `ITargetPreparer` cài đặt một apk và các bài kiểm thử của apk đó.
ArtChrootPreparer	Tạo thư mục chroot cho các kiểm thử ART.
BaseEmulatorPreparer	Trình chuẩn bị chung để 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ị vô hiệu hoá hay không.
BuildInfoRecorder	Một `ITargetPreparer` ghi siêu dữ liệu thông tin bản dựng vào một tệp được chỉ định.
CheckPairingPreparer	Một `CompanionAwarePreparer` xác minh quá trình liên kết BT giữa thiết bị chính và thiết bị đồng hành
CompanionAllocator	Lớp cơ sở chịu trách nhiệm phân bổ và giải phóng thiết bị đồng hành `getCompanionDeviceSelectionOptions()` phải được triển khai để mô tả các tiêu chí cần thiết để phân bổ thiết bị đồng hành
CompanionAwarePreparer	Một `ITargetPreparer` đóng gói logic để lấy một thiết bị đồng hành đã được phân bổ.
CompanionRunCommandTargetPreparer	Một `ITargetPreparer` chạy các lệnh được chỉ định trên thiết bị đồng hành được phân bổ
CompanionTestAppInstallSetup	Một `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".
CpuThrottlingWaiter	Một `ITargetPreparer` đợi cho đến khi tần số tối đa trên tất cả các lõi được khôi phục về mức cao nhất có thể
CreateAvdPreparer
CreateUserPreparer	Đối tượng chuẩn bị để tạo người dùng và dọn dẹp người dùng đó vào cuối.
DeviceActionTargetPreparer	`ITargetPreparer` để thực hiện các thao tác trên thiết bị.
DeviceBuildInfoBootStrapper	Một `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	Một `ITargetPreparer` chèn siêu dữ liệu `DeviceBuildDescriptor` vào `IBuildInfo`.
DeviceCleaner	Thực hiện thao tác khởi động lại hoặc định dạng làm thao tác dọn dẹp sau khi kiểm thử và có thể tắt màn hình
DeviceFlashPreparer	Một `ITargetPreparer` cài đặt ROM hình ảnh trên phần cứng Android thực.
DeviceImageZipFlashingTargetPreparer	Một 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 thông qua một định dạng cụ thể.
DeviceOwnerTargetPreparer	Một `ITargetPreparer` thiết lập thành phần chủ sở hữu thiết bị.
DeviceSetup	Một `ITargetPreparer` định cấu hình thiết bị để kiểm thử dựa trên `Option` được cung cấp.
DeviceStorageFiller	Mục tiêu của người chuẩn bị là lấp đầy bộ nhớ để có một lượng dung lượng trống nhất định.
DeviceStringPusher	Trình chuẩn bị mục tiêu để ghi một chuỗi vào tệp.
DeviceUpdateTargetPreparer	Một `ITargetPreparer` trừu tượng xử lý các bước chung 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 (khác với dịch vụ bản dựng).
DeviceWiper	Một `ITargetPreparer` xoá dữ liệu người dùng
DisableSELinuxTargetPreparer	Trình chuẩn bị mục tiêu vô hiệu hoá SELinux nếu được bật.
DynamicSystemPreparer	Một `ITargetPreparer` thiết lập hình ảnh hệ thống trên bản dựng thiết bị bằng Bản cập nhật hệ thống động.
EraseUserDataPreparer	Một `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 fastboot và gửi các lệnh fastboot.
FastbootUpdateBootstrapPreparer	Một `ITargetPreparer` dàn dựng các tệp được chỉ định (trình tải khởi động, đài, tệp ZIP hình ảnh thiết bị) vào `IDeviceBuildInfo` để các thiết bị được flash 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 được điều chỉnh bởi một dịch vụ từ xa).
FoldableModePreparer	Một trình chuẩn bị mục tiêu có thể chuyển đổi trạng thái gập của thiết bị.
FolderSaver	Một `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ý.
FutilityCommandPreparer	Người chuẩn bị thực hiện các lệnh vô ích.
GkiDeviceFlashPreparer	Một trình chuẩn bị mục tiêu sẽ flash thiết bị bằng hình ảnh chung của nhân chung Android.
GoogleAccountPreparer	Một `ITargetPreparer` hỗ trợ việc định cấu hình tài khoản Google.
GsiDeviceFlashPreparer	Một 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.
ILabPreparer	Giao diện đánh dấu cho người chuẩn bị phòng thí nghiệm Hãy xem phần `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	Một `ITargetPreparer` cài đặt tất cả ứng dụng trong tệp zip kiểm thử.
InstallApexModuleTargetPreparer
InstallApkSetup	Một `ITargetPreparer` cài đặt một hoặc nhiều apk nằm trên hệ thống tệp.
InstallBuildEnvApkSetup	Một `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	Một trình chuẩn bị mục tiêu cài đặt các mô-đun kernel.
InstrumentationPreparer	Một `ITargetPreparer` chạy công cụ đo lường
KillExistingEmulatorPreparer	`ITargetPreparer` tắt mộ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 khởi chạy trình mô phỏng cục bộ từ môi trường bản dựng Android.
LocalEmulatorSnapshot	TargetPreparer dùng để tạo một ả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	Một `ITargetPreparer` cho phép kết hợp hình ảnh nhân với hình ảnh thiết bị.
MixRadioTargetPreparer	Một `ITargetPreparer` cho phép kết hợp hình ảnh vô tuyến với hình ảnh thiết bị.
ModuleOemTargetPreparer
NativeLeakCollector	Một `ITargetPreparer` chạy "dumpsys meminfo --unreachable -a" để xác định bộ nhớ gốc không thể truy cập mà mỗi quy trình hiện đang 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ị tại 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 dùng nữa. Thay vào đó, hãy sử dụng `PushFilePreparer`
PushFilePreparer	Một `ITargetPreparer` cố gắng chuyển bất kỳ số lượng tệp nào từ bất kỳ đường dẫn máy chủ lưu trữ nào đến bất kỳ đường dẫn thiết bị nào.
PythonVirtualenvPreparer	Thiết lập một 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	Một trình chuẩn bị mục tiêu dùng để thu thập nhật ký trước khi khôi phục.
RemoveSystemAppPreparer	Một `ITargetPreparer` để xoá apk khỏi phân vùng hệ thống trước khi chạy thử nghiệm.
RestartSystemServerTargetPreparer	Trình chuẩn bị đích 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 lựa 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ủ lưu trữ trước và sau khi chạy kiểm thử.
RunHostScriptTargetPreparer	Target preparer (trình chuẩn bị mục tiêu) thực thi một tập lệnh trước khi chạy một quy trình kiểm thử.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Một `ITargetPreparer` để đánh dấu rằng các kiểm thử sẽ chạy trong hộp cát SDK.
RunOnSecondaryUserTargetPreparer	Một `ITargetPreparer` để đảm bảo rằng quá trình kiểm thử chạy dưới dạng người dùng phụ.
RunOnSystemUserTargetPreparer	Một `ITargetPreparer` đánh dấu rằng các kiểm thử sẽ được chạy trên người dùng (thay vì người dùng hiện tại).
RunOnWorkProfileTargetPreparer	Một `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ẽ được chạy ở người dùng đó.
SemaphoreTokenTargetPreparer	Đây là một trình chuẩn bị được 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ủ lưu trữ tradefed.
SideloadOtaTargetPreparer	Một trình chuẩn bị mục tiêu thực hiện việc tải gói OTA đã chỉ định lên thiết bị, á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 của thiết bị để 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	Một `ITargetPreparer` ngừng cung cấp dịch vụ trên thiết bị.
StubTargetPreparer	Phương thức triển khai trống của phần giữ chỗ cho `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	Một `ITargetPreparer` chuyển sang loại người dùng được chỉ định trong setUp.
TearDownPassThroughPreparer	Cho phép chạy tearDown trên những trình chuẩn bị có trong cấu hình dưới dạng một đối tượng.
TemperatureThrottlingWaiter	Một `ITargetPreparer` chờ cho đến khi nhiệt độ của thiết bị giảm xuống mức mục tiêu
TestAppInstallSetup	Một `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	Một `ITargetPreparer` đẩy một hoặc nhiều tệp/thư mục từ thư mục `IDeviceBuildInfo.getTestsDir()` lên thiết bị.
TestSystemAppInstallSetup	Một `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ó khả năng khởi động lại thiết bị.
UserCleaner	Một `ITargetPreparer` sẽ xoá người dùng phụ khi tháo rời.
VisibleBackgroundUserPreparer	Trình chuẩn bị mục tiêu để chạy các kiểm thử trong một người dùng được bắt đầu ở chế độ nền.
WaitForDeviceDatetimePreparer	Một `ITargetPreparer` chờ ngày giờ được đặt trên thiết bị Không bắt buộc, trình chuẩn bị này có thể buộc `TargetSetupError` nếu ngày giờ không được đặt trong thời gian chờ.
WifiPreparer	Một `ITargetPreparer` định cấu hình Wi-Fi trên thiết bị nếu cần.

Chuẩn bị môi trường kiểm thử cho quá trình 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ử, khởi 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 để mỗi ITargetPreparer ghi lại rõ ràng chế độ thiết lập trước và sau môi trường dự kiến. Ví dụ: ITargetPreparer định cấu hình thiết bị để kiểm thử phải chạy sau 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 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 chế độ thiết lập mục tiêu để kiểm thử.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Thực hiện dọn dẹp/tháo dỡ 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 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 dùng nữa.
Thay vào đó, hãy sử dụng setUp(com.android.tradefed.invoker.TestInformation)

Thực hiện chế độ 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 chế độ 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 dọn dẹp/tháo dỡ 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 bắt ở cấp Lệnh gọi. Nếu không, giá trị 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 dùng nữa.
Thay vào đó, hãy sử dụng tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Thực hiện dọn dẹp/tháo dỡ 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 bắt ở cấp Lệnh gọi. Nếu không, giá trị sẽ là `null`.

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