Trình chuẩn bị mục tiêu

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Các lớp con gián tiếp đã biết 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ừ một IDeviceBuildInfo#getTestsDir() trên thiết bị.  Trình chuẩn bị mục tiêu cho mục tiêu ITargetPreparer thực hiện một loạt thao tác (ví dụ: nhấp và vuốt) bằng cách sử dụng Giao thức Phụ kiện mở Android (AOAv2).  Thiết lập ứng dụng Một ITargetPreparer cài đặt một tệp APK và các chương trình kiểm thử của tệp APK đó.  ArtChrootChuẩn bị Tạo thư mục chroot để kiểm thử ART.  BaseEmulatorPreparer (Trình mô phỏng chuẩn) Trình chuẩn bị phổ biến để chạy trình mô phỏng cục bộ.  BaseTargetTargetr (Trình chuẩn bị cơ sở) Lớp triển khai cơ sở cho ITargetPreparer cho phép kiểm soát việc đối tượng đã bị tắt hay chưa.  BuildInfoRecorder Một ITargetPreparer ghi siêu dữ liệu thông tin bản dựng vào một tệp cụ thể.  Kiểm tra Trình chuẩn bị ghép nối CompanionAwarePreparer xác minh liên kết BT giữa thiết bị chính và thiết bị đồng hành companionallocator Lớp cơ sở đảm nhận việc phân bổ và giải phóng thiết bị đồng hành Bạn phải triển khai getCompanionDeviceSelectionOptions() để mô tả tiêu chí cần để phân bổ thiết bị đồng hành Đồng hành chuẩn bị Một ITargetPreparer đóng gói logic về việc nhận một quảng cáo đồng hành đã được phân bổ thiết 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 Một ITargetPreparer cài đặt một hoặc nhiều ứng dụng từ một IDeviceBuildInfo#getTestsDir() thư mục vào một thiết bị đồng hành được phân bổ.  CompileBootImageWithSpeedTargetSupportedr (Trình biên dịchBootImageWithTốc mục tiêu chuẩn bị) 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 ITargetPreparer chờ cho đến khi tần suất tối đa trên tất cả các lõi được khôi phục lên mức cao nhất cấp độ hiện có CreateAvdPreparer   CreateUser Preparer (Trình chuẩn bị người tạo) Trình chuẩn bị nhắm mục tiêu để tạo người dùng và dọn dẹp người dùng ở bước cuối.  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ử 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.  Dọn dẹp thiết bị 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à tắt màn hình (không bắt buộc) Device FlashChuẩn bị 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 sẽ cài đặt ROM thiết bị cùng với hình ảnh thiết bị được cung cấp qua một định dạng cụ thể.  DeviceOwnerTargetPreparer Một ITargetPreparer thiết lập thành phần của chủ sở hữu thiết bị.  Thiết lập thiết bị 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 (Bộ nhớ thiết bị) Hãy nhắm mục tiêu để trình chuẩn bị lấp đầy bộ nhớ để có thêm 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.  DeviceUpdateTarget Preparer (Trình cập nhật mục tiêu của thiết bị) ITargetPreparer trừu tượng xử lý các bước phổ biến khi cập nhật thiết bị bằng tệp hình ảnh thiết bị từ nguồn bên ngoài (không phải dịch vụ bản dựng).  Xoá thiết bị ITargetPreparer xoá sạch dữ liệu người dùng TắtSELinuxTargetPreparer Trình chuẩn bị mục tiêu sẽ tắt SELinux nếu được bật.  DynamicSystemChuẩn bị Một ITargetPreparer thiết lập hình ảnh hệ thống ở trên bản dựng thiết bị bằng thành phần Dynamic Bản cập nhật hệ thống.  XoáUserDataPreparer 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 quá trình khởi động nhanh và gửi lệnh khởi động nhanh.  QuickbootUpdateBootstrapPreparer Một ITargetPreparer để triển khai các tệp được chỉ định (trình tải khởi động, đài, mã zip hình ảnh thiết bị) vào IDeviceBuildInfo để cài đặt ROM 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ả.  FeatureflagTarget Preparer Cập nhật DeviceConfig (cờ tính năng được điều chỉnh bằng dịch vụ từ xa).  Để chuẩn bị hình ảnh chế độ xem có thể gập lại Một trình chuẩn bị mục tiêu có thể chuyển đổi trạng thái gập của một thiết bị.  Trình lưu thư mục ITargetPreparer kéo các thư mục ra khỏi thiết bị, nén và lưu thư mục đó vào nhật ký phần phụ trợ.  GkiDeviceFlashPreparer Một trình chuẩn bị mục tiêu cài đặt ROM cho thiết bị bằng hình ảnh chung cho nhân hệ điều hành phổ biến Android.  GsiDeviceFlashPreparer Một trình chuẩn bị mục tiêu cài đặt ROM hình ảnh hệ thống chung của Android cho thiết bị.  ILabChuẩn bị 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. BreakDown được chuyển sang giao diện ITargetPreparer cơ sở.  InstallAllTestZipAppsSetup ITargetPreparer cài đặt tất cả ứng dụng ở dạng tệp zip kiểm thử.  InstallApexModuleTargetSupportedr   InstallApkSetup Một ITargetPreparer cài đặt một hoặc nhiều tệp 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 thử nghiệm qua một môi trường bản dựng nền tảng Android.  InstallKernelModuleOutcomer Một trình chuẩn bị mục tiêu cài đặt ROM cho thiết bị bằng hình ảnh chung cho nhân hệ điều hành phổ biến Android.  Instrumentation Preparer (Trình chuẩn bị thiết bị) ITargetPreparer chạy khả năng đo lường KillHiện cóTrình mô phỏng chuẩn bị ITargetPreparer tắt một trình mô phỏng đang chạy.  Trình chuẩn bị lỗi đã biết Trình chuẩn bị mục tiêu bỏ qua việc thử lại lỗi đã biết.  LocalEmulatorLaunch Mục tiêu chuẩn bị khởi chạy trình mô phỏng cục bộ từ môi trường bản dựng Android.  LocalEmulatorSnapshot Mục tiêu chuẩn bị nhằm tạo một ảnh chụp nhanh trình mô phỏng sạch từ Android môi trường xây dựng/phát triển MixKernelTarget chuẩn bị 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 lưu giữ bởi mỗi tiến trình.  NoApkTestSkipper (Trình bỏ qua bước kiểm thử NoApkTest) 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 có không phải là tệp apk để kiểm thử.  PerfettoPreparer Người chuẩn bị Perfetto đẩy tệp cấu hình vào thiết bị tại vị trí chuẩn mà perfetto có quyền truy cập.  ProfileTargetTargetr (Trình chuẩn bị hồ sơ) Lớp cơ sở để thiết lập trình chuẩn bị mục tiêu cho người dùng hồ sơ android.os.usertype.profile.XXX bất kỳ.  PushFileInvoker Lớp này không được dùng nữa. Thay vào đó, hãy sử dụng PushFilePreparer PushFile Preparer (Trình chuẩn bị tệp đẩy) ITargetPreparer cố gắng đẩy số lượng tệp bất kỳ từ đường dẫn máy chủ bất kỳ đến bất kỳ đường dẫn thiết bị.  PythonVirtualenvPreparer (Trình chuẩn bị Python) Thiết lập một Virtualenv Python trên máy chủ lưu trữ và cài đặt các gói.  RestartTargetPreferencesr (Trình khởi động lại mục tiêu chuẩn bị) Trình chuẩn bị mục tiêu sẽ khởi động lại thiết bị.  RecoveryLogChuẩn bị 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.  RemoveSystemApptagmanagerr ITargetPreparer để xoá một tệp APK khỏi phân vùng hệ thống trước khi chạy kiểm thử.  Khởi động lạiSystemServerTargetPreparer Trình chuẩn bị mục tiêu sẽ khởi động lại máy chủ hệ thống mà không cần khởi động lại thiết bị.  RootTarget chuẩn bị Trình chuẩn bị mục tiêu thực hiện "gốc adb" hoặc "adb unroot" dựa trên tuỳ chọn "force-root".  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetDefaultr Trình chuẩn bị mục tiêu sẽ chạy các lệnh máy chủ tuỳ ý trước và sau khi chạy kiểm thử.  RunHostScriptTargetAttachr Trình chuẩn bị mục tiêu sẽ thực thi một tập lệnh trước khi chạy kiểm thử.  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   Trình chuẩn bị RunOnSdkSandboxSandboxTarget ITargetPreparer để đánh dấu các bài kiểm thử nên chạy trong hộp cát SDK.  RunOnPrimaryUserTargetPreparer ITargetPreparer để đảm bảo bài kiểm thử chạy với tư cách là người dùng phụ.  RunOnSystemUserTargetPreparer ITargetPreparer đánh dấu rằng kiểm thử nên được chạy trên người dùng (thay vì người dùng hiện tại).  RunOnWorkProfileTargetHiệu ứng ITargetPreparer tạo hồ sơ công việc trong quá trình thiết lập và đánh dấu rằng chương trình kiểm thử nên chạy trong người dùng đó.  SemaphoreTokenTargetPreparer Đây là một 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 thử nghiệm trong máy chủ được giao dịch.  SideloadOtaTarget Preparer (Trình chuẩn bị mục tiêu không qua cửa hàng ứng dụng) Một trình chuẩn bị mục tiêu thực hiện việc tải không qua cửa hàng của một gói OTA đã chỉ định, áp dụng gói này, chờ cho thiết bị khởi động và chèn thuộc tính bản dựng 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 có áp dụng bản dựng mới.  StopServicesSetup (Thiết lập dịch vụ dừng) Một ITargetPreparer dừng các dịch vụ trên thiết bị.  Trình chuẩn bị mục tiêu Sttub Phương thức triển khai ITargetPreparer cho phần giữ chỗ trống.  SuiteApkInstaller Số lần cài đặt APK được chỉ định cho cấu hình Suite: từ $ANDROID_TARGET_OUT_TESTCASES hoặc ROOT_DIR trong thông tin bản dựng. SwitchUserTarget Preparer (Trình chuyển đổi mục tiêu chuẩn bị) ITargetPreparer chuyển sang loại người dùng được chỉ định trong setUp.  TearDownPassThroughPreparer Cho phép chạy quá trình phân tách đối với các trình chuẩn bị được đưa vào một cấu hình dưới dạng đối tượng.  Nhiệt độThrottlingWaiter ITargetPreparer chờ cho đến khi nhiệt độ của thiết bị giảm xuống để đạt mục tiêu TestAppInstallSetup ITargetPreparer cài đặt một hoặc nhiều ứng dụng từ mộ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ị.  TimeWter (Người mất thời gian) Một công cụ 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ị.  Trình dọn dẹp người dùng ITargetPreparer xoá người dùng phụ khi chia nhỏ.  DisplayBackgroundUserAvailabler Trình chuẩn bị mục tiêu để chạy kiểm thử ở người dùng được bắt đầu ở chế độ nền.  WaitForDeviceDatetimePreparer ITargetPreparer chờ thiết lập ngày giờ 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 không thiết lập ngày giờ trong .  WifiChuẩn bị 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ử để chạy kiểm thử.

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

Lưu ý rằng bạn có thể chỉ định nhiều ITargetPreparer trong một cấu hình. Đó là đề xuất rằng mỗi ITargetPreparer ghi lại rõ ràng môi trường dự kiến được thiết lập trước và sau khi thiết lập. ví dụ: ITarget chuẩn bị định cấu hình thiết bị để thử nghiệm phải được chạy sau khi ITarget Preparer có 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) Thiết lập mục tiêu để kiểm thử.
default void	tearDown(TestInformation testInformation, Throwable e) Tiến hành 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 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

thiết lập

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)

Thiết lập mục tiêu để kiểm thử.

Tham số
device	ITestDevice: ITestDevice để 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

thiết lập

public void setUp (TestInformation testInformation)

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 đang chuẩn bị bản dựng
DeviceNotAvailableException	nếu thiết bị không phản hồi

xé hình

public void tearDown (TestInformation testInformation, 
                Throwable e)

Tiến hành 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 với một ngoại lệ, thì đây sẽ là ngoại lệ bắt gặp ở cấp Lời 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

xé hình

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)

Tiến hành dọn dẹp/gỡ bỏ mục tiêu sau khi kiểm thử.

Tham số
device	ITestDevice: ITestDevice để 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 với một ngoại lệ, thì đây sẽ là ngoại lệ bắt gặp ở cấp Lời 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