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