ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

คลาสย่อยโดยอ้อมที่ทราบ AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter และอื่นๆ 76 รายการ AdbStopServerPreparer เตรียมเป้าหมายเพื่อหยุดเซิร์ฟเวอร์ adb ในโฮสต์ก่อนและหลังการทดสอบ adb  AllTestAppsInstallSetup ITargetPreparer ที่ติดตั้งแอปทั้งหมดจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในอุปกรณ์  AoaTargetPreparer ITargetPreparer ที่ใช้ดำเนินการชุดหนึ่งๆ (เช่น การคลิกและการปัด) โดยใช้โปรโตคอล Android Open Accessory (AOAv2)  AppSetup ITargetPreparer ที่ติดตั้ง apk และการทดสอบ  ArtChrootPreparer สร้างไดเรกทอรี chroot สำหรับการทดสอบ ART  BaseEmulatorPreparer การเตรียมการทั่วไปสำหรับการเปิดใช้งานโปรแกรมจำลองในเครื่อง  BaseTargetPreparer คลาสการใช้งานพื้นฐานสําหรับ ITargetPreparer ที่ช่วยให้ควบคุมได้ว่าจะให้ปิดใช้ออบเจ็กต์หรือไม่  BuildInfoRecorder ITargetPreparer ที่เขียนข้อมูลเมตาของข้อมูลการสร้างลงในไฟล์ที่ระบุ  CheckPairingPreparer CompanionAwarePreparer ที่ยืนยันการจับคู่ BT ระหว่างอุปกรณ์หลักกับอุปกรณ์เสริม  CompanionAllocator คลาสพื้นฐานที่จัดการการจัดสรรและการปล่อยอุปกรณ์ที่ใช้ร่วมกัน คุณควรใช้ getCompanionDeviceSelectionOptions() เพื่ออธิบายเกณฑ์ที่จําเป็นในการกําหนดอุปกรณ์ที่ใช้งานร่วมกัน  CompanionAwarePreparer ITargetPreparer ที่รวมตรรกะในการรับอุปกรณ์ที่กําหนดไว้แล้ว   CompanionRunCommandTargetPreparer ITargetPreparer ที่เรียกใช้คําสั่งที่ระบุในอุปกรณ์ที่มาพร้อมที่ให้ยืม  CompanionTestAppInstallSetup ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในอุปกรณ์เสริมที่จัดสรรไว้  CompileBootImageWithSpeedTargetPreparer คอมไพล์คลาสพาธการบูตและเซิร์ฟเวอร์ระบบอีกครั้งด้วยตัวกรองคอมไพเลอร์ "speed"  CpuThrottlingWaiter ITargetPreparer ที่รอจนกว่าความถี่สูงสุดในคอร์ทั้งหมดจะได้รับการกู้คืนเป็นระดับสูงสุดที่พร้อมใช้งาน  CreateAvdPreparer   CreateUserPreparer เตรียมเป้าหมายสําหรับการสร้างผู้ใช้และล้างข้อมูลในตอนท้าย  DeviceActionTargetPreparer ITargetPreparer เพื่อดำเนินการกับอุปกรณ์  DeviceBuildInfoBootStrapper ITargetPreparer ที่แทนที่ช่องข้อมูลบิลด์ด้วยแอตทริบิวต์ที่อ่านจากอุปกรณ์ ซึ่งมีประโยชน์สำหรับการทดสอบอุปกรณ์ด้วยบิลด์ที่สร้างจากแหล่งที่มาภายนอก (เช่น  DeviceBuildInfoInjector ITargetPreparer ที่แทรกข้อมูลเมตา DeviceBuildDescriptor ลงใน IBuildInfo  DeviceCleaner ดำเนินการรีบูตหรือฟอร์แมตเป็นการล้างข้อมูลหลังจากการทดสอบ และปิดหน้าจอ (ไม่บังคับ)  DeviceFlashPreparer ITargetPreparer ที่กะพริบรูปภาพบนฮาร์ดแวร์ Android  DeviceImageZipFlashingTargetPreparer เครื่องมือเตรียมเป้าหมายที่จะแฟลชอุปกรณ์ด้วยรูปภาพอุปกรณ์ที่ระบุผ่านรูปแบบที่เฉพาะเจาะจง  DeviceOwnerTargetPreparer ITargetPreparer ที่ตั้งค่าคอมโพเนนต์เจ้าของอุปกรณ์  DeviceSetup ITargetPreparer ที่กำหนดค่าอุปกรณ์สำหรับการทดสอบตาม Option ที่ระบุ  DeviceStorageFiller เตรียมอุปกรณ์เป้าหมายให้เต็มพื้นที่เก็บข้อมูลเพื่อให้มีพื้นที่ว่างบางส่วน  DeviceStringPusher เครื่องมือเตรียมเป้าหมายเพื่อเขียนสตริงลงในไฟล์  DeviceUpdateTargetPreparer ITargetPreparer นามธรรมที่จัดการขั้นตอนทั่วไปเกี่ยวกับการอัปเดตอุปกรณ์ด้วยไฟล์ภาพอุปกรณ์จากแหล่งที่มาภายนอก (ไม่ใช่บริการบิลด์)  DeviceWiper ITargetPreparer ที่ล้างข้อมูลผู้ใช้  DisableSELinuxTargetPreparer เครื่องมือเตรียมเป้าหมายที่ปิดใช้ SELinux หากเปิดใช้  DynamicSystemPreparer ITargetPreparer ที่ตั้งค่าอิมเมจระบบบนบิลด์อุปกรณ์ที่มีการอัปเดตระบบแบบไดนามิก  EraseUserDataPreparer ITargetPreparer ที่ล้างข้อมูลผู้ใช้ในอุปกรณ์  FastbootCommandPreparer เครื่องมือเตรียมเป้าหมายที่เรียกใช้ Fastboot และส่งคำสั่ง Fastboot  FastbootUpdateBootstrapPreparer ITargetPreparer ที่จัดเตรียมไฟล์ที่ระบุ (บูตโหลดเดอร์ วิทยุ ไฟล์ ZIP ของภาพอุปกรณ์) ลงใน IDeviceBuildInfo เพื่อแฟลชอุปกรณ์ด้วย FastbootDeviceFlasher จากนั้นแทรกแอตทริบิวต์ของอุปกรณ์หลังการบูตลงในข้อมูลบิลด์เพื่อวัตถุประสงค์ในการรายงานผล  FeatureFlagTargetPreparer อัปเดต DeviceConfig (Flag ฟีเจอร์ที่ปรับโดยบริการระยะไกล)  FoldableModePreparer เครื่องมือเตรียมเป้าหมายที่สามารถเปลี่ยนสถานะแบบพับของอุปกรณ์  FolderSaver ITargetPreparer ที่ดึงไดเรกทอรีออกจากอุปกรณ์ บีบอัด และบันทึกลงในแบ็กเอนด์การบันทึก  GkiDeviceFlashPreparer เครื่องมือเตรียมเป้าหมายที่จะแฟลชอุปกรณ์ด้วยรูปภาพทั่วไปของเคอร์เนล Android ทั่วไป  GsiDeviceFlashPreparer เครื่องมือเตรียมเป้าหมายที่จะแฟลชอุปกรณ์ด้วยอิมเมจระบบทั่วไปของ Android  ILabPreparer อินเทอร์เฟซเครื่องหมายสำหรับผู้เตรียมห้องทดลอง ดูคำอธิบายวัตถุประสงค์ของอินเทอร์เฟซเหล่านี้ได้ที่ ITargetPreparer  ITargetCleaner อินเทอร์เฟซนี้เลิกใช้งานแล้ว ย้าย tearDown ไปยังอินเทอร์เฟซ ITargetPreparer พื้นฐานแล้ว  InstallAllTestZipAppsSetup ITargetPreparer ที่ติดตั้งแอปทั้งหมดในไฟล์ ZIP ทดสอบ  InstallApexModuleTargetPreparer   InstallApkSetup ITargetPreparer ที่ติดตั้ง APK อย่างน้อย 1 รายการที่อยู่ในระบบไฟล์  InstallBuildEnvApkSetup ITargetPreparer ที่ติดตั้ง APK ทดสอบอย่างน้อย 1 รายการจากสภาพแวดล้อมการสร้างแพลตฟอร์ม Android  InstallKernelModulePreparer เครื่องมือเตรียมเป้าหมายที่ติดตั้งโมดูลเคอร์เนล  InstrumentationPreparer ITargetPreparer ที่เรียกใช้เครื่องมือวัด  KillExistingEmulatorPreparer ITargetPreparer ที่ปิดโปรแกรมจำลองที่ทำงานอยู่  KnownFailurePreparer ให้ผู้เตรียมเป้าหมายข้ามการลองอีกครั้งที่ทราบอยู่แล้ว  LocalEmulatorLaunch TargetPreparer ที่เปิดโปรแกรมจำลองในเครื่องจากสภาพแวดล้อมการสร้าง Android  LocalEmulatorSnapshot TargetPreparer มีไว้สำหรับสร้างสแนปชอตโปรแกรมจำลองที่สะอาดจากสภาพแวดล้อมการสร้าง/การพัฒนา Android  MixKernelTargetPreparer ITargetPreparer ที่อนุญาตให้ผสมรูปภาพเคอร์เนลกับรูปภาพอุปกรณ์  ModuleOemTargetPreparer   NativeLeakCollector ITargetPreparer ที่เรียกใช้ "dumpsys meminfo --unreachable -a" เพื่อระบุหน่วยความจำเนทีฟที่เข้าถึงไม่ได้ซึ่งแต่ละกระบวนการเก็บไว้  NoApkTestSkipper เครื่องมือเตรียมความพร้อมพิเศษที่ช่วยให้คุณข้ามการเรียกใช้ (การเตรียมและการทดสอบ) ทั้งหมดได้หากไม่มี APK ที่จะทดสอบ  PerfettoPreparer เครื่องมือเตรียมข้อมูลของ Perfetto จะส่งไฟล์การกําหนดค่าไปยังอุปกรณ์ในตําแหน่งมาตรฐานที่ Perfetto มีสิทธิ์เข้าถึง  ProfileTargetPreparer คลาสพื้นฐานสําหรับการตั้งค่าเครื่องมือเตรียมเป้าหมายสําหรับผู้ใช้โปรไฟล์ android.os.usertype.profile.XXX  PushFileInvoker คลาสนี้เลิกใช้งานแล้ว ใช้ PushFilePreparer แทน  PushFilePreparer ITargetPreparer ที่พยายามพุชไฟล์จำนวนเท่าใดก็ได้จากเส้นทางโฮสต์ใดก็ได้ไปยังเส้นทางอุปกรณ์ใดก็ได้  PythonVirtualenvPreparer ตั้งค่า virtualenv ของ Python ในโฮสต์และติดตั้งแพ็กเกจ  RebootTargetPreparer เครื่องมือเตรียมอุปกรณ์เป้าหมายที่จะรีบูตอุปกรณ์  RecoveryLogPreparer เครื่องมือเตรียมเป้าหมายที่ใช้รวบรวมบันทึกก่อนการกู้คืน  RemoveSystemAppPreparer ITargetPreparer สำหรับการนำ APK ออกจากพาร์ติชันระบบก่อนการทดสอบ  RestartSystemServerTargetPreparer เครื่องมือเตรียมเป้าหมายที่จะรีสตาร์ทเซิร์ฟเวอร์ระบบโดยไม่ต้องรีบูตอุปกรณ์  RootTargetPreparer เครื่องมือเตรียมเป้าหมายที่ใช้ "adb root" หรือ "adb unroot" ตามตัวเลือก "force-root"  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetPreparer กำหนดผู้เตรียมเป้าหมายให้เรียกใช้คำสั่งของโฮสต์ที่กำหนดเองก่อนและหลังการทดสอบ  RunHostScriptTargetPreparer เครื่องมือเตรียมเป้าหมายที่จะเรียกใช้สคริปต์ก่อนทำการทดสอบ  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer เพื่อระบุว่าการทดสอบควรทํางานในแซนด์บ็อกซ์ sdk  RunOnSecondaryUserTargetPreparer ITargetPreparer เพื่อให้การทดสอบทํางานในฐานะผู้ใช้รอง  RunOnSystemUserTargetPreparer ITargetPreparer ที่ระบุว่าควรทำการทดสอบกับผู้ใช้ (แทนที่จะเป็นผู้ใช้ปัจจุบัน)  RunOnWorkProfileTargetPreparer ITargetPreparer ที่สร้างโปรไฟล์งานในการตั้งค่า และทําเครื่องหมายว่าควรเรียกใช้การทดสอบในผู้ใช้รายนั้น  SemaphoreTokenTargetPreparer นี่คือเครื่องมือเตรียมที่ใช้โทเค็นเพื่อจัดเรียงลําดับการเรียกใช้การทดสอบในโฮสต์ Tradefed  SideloadOtaTargetPreparer เครื่องมือเตรียมเป้าหมายที่ดำเนินการโหลดจากภายนอกของแพ็กเกจ OTA ที่ระบุ ใช้แพ็กเกจ รอให้อุปกรณ์บูต และแทรกพร็อพเพอร์ตี้การสร้างอุปกรณ์เพื่อใช้เป็นข้อมูลการสร้าง เครื่องมือเตรียมเป้าหมายนี้จะถือว่าอุปกรณ์จะอยู่ในโหมด adb ปกติเมื่อเริ่มต้น และตรวจสอบว่าอุปกรณ์จะออกจากโหมดเดียวกันนี้แต่ใช้บิลด์ที่ใหม่กว่า  StopServicesSetup ITargetPreparer ที่หยุดบริการในอุปกรณ์  StubTargetPreparer การใช้งานตัวยึดตําแหน่งว่างของ ITargetPreparer  SuiteApkInstaller ติดตั้ง APK ที่ระบุสำหรับการกำหนดค่าชุดทดสอบจากตัวแปร $ANDROID_TARGET_OUT_TESTCASES หรือ ROOT_DIR ในข้อมูลบิลด์  SwitchUserTargetPreparer ITargetPreparer ที่เปลี่ยนไปใช้ประเภทผู้ใช้ที่ระบุใน setUp  TearDownPassThroughPreparer อนุญาตให้เรียกใช้ tearDown กับเครื่องมือเตรียมข้อมูลที่รวมอยู่ในการกำหนดค่าเป็นออบเจ็กต์  TemperatureThrottlingWaiter ITargetPreparer ที่รอจนกว่าอุณหภูมิของอุปกรณ์จะลดลงถึงเป้าหมาย  TestAppInstallSetup ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในอุปกรณ์  TestFilePushSetup ITargetPreparer ที่พุชไฟล์/ไดเรกทอรีอย่างน้อย 1 รายการจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ไปยังอุปกรณ์  TestSystemAppInstallSetup ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในพาร์ติชัน /system บนอุปกรณ์  TimeWaster เครื่องมือเตรียมเป้าหมายแบบง่ายที่เสียเวลาและอาจต้องรีสตาร์ทอุปกรณ์  UserCleaner ITargetPreparer ที่นำผู้ใช้รองออกเมื่อมีการเลิกใช้งาน  VisibleBackgroundUserPreparer เครื่องมือเตรียมเป้าหมายสําหรับการเรียกใช้การทดสอบในผู้ใช้ที่เริ่มทำงานในเบื้องหลัง  WaitForDeviceDatetimePreparer ITargetPreparer ที่รอการตั้งค่าวันที่และเวลาในอุปกรณ์ ตัวเลือกนี้อาจบังคับให้ใช้ TargetSetupError หากไม่ได้ตั้งค่า datetime ภายในเวลาหมด  WifiPreparer ITargetPreparer ที่กําหนดค่า Wi-Fi ในอุปกรณ์ หากจําเป็น

---

เตรียมสภาพแวดล้อมการทดสอบสําหรับการทดสอบ

เช่น ติดตั้งซอฟต์แวร์ ปรับการตั้งค่าสภาพแวดล้อมสําหรับการทดสอบ เปิดใช้งานเป้าหมาย ฯลฯ

โปรดทราบว่าคุณระบุ ITargetPreparer หลายรายการได้ในการกำหนดค่า ขอแนะนำให้ ITargetPreparer แต่ละรายการบันทึกสภาพแวดล้อมก่อนและหลังการตั้งค่าที่คาดไว้อย่างชัดเจน เช่น ITargetPreparer ที่กําหนดค่าอุปกรณ์สําหรับการทดสอบต้องเรียกใช้หลังจาก ITargetPreparer ที่ติดตั้งซอฟต์แวร์

สรุป

เมธอดสาธารณะ
default void	setUp(ITestDevice device, IBuildInfo buildInfo) เราเลิกใช้งานเมธอดนี้แล้ว ใช้ setUp(com.android.tradefed.invoker.TestInformation) แทน
default void	setUp(TestInformation testInformation) ตั้งค่าเป้าหมายสําหรับการทดสอบ
default void	tearDown(TestInformation testInformation, Throwable e) ทําการล้าง/รื้อถอนเป้าหมายหลังจากการทดสอบ
default void	tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e) เราเลิกใช้งานเมธอดนี้แล้ว ใช้ tearDown(com.android.tradefed.invoker.TestInformation, Throwable) แทน

เมธอดสาธารณะ

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

วิธีการนี้เลิกใช้งานแล้ว
ใช้ setUp(com.android.tradefed.invoker.TestInformation) แทน

ตั้งค่าเป้าหมายสําหรับการทดสอบ

พารามิเตอร์
device	ITestDevice: ITestDevice ที่จะเตรียม
buildInfo	IBuildInfo: ข้อมูลเกี่ยวกับบิลด์ที่ทดสอบ

โยน
TargetSetupError	if fatal error occurred setting up environment
BuildError	หากเกิดข้อผิดพลาดเกี่ยวกับ BuildInfo
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

setUp

public void setUp (TestInformation testInformation)

ตั้งค่าเป้าหมายสําหรับการทดสอบ

พารามิเตอร์
testInformation	TestInformation: TestInformation ของการเรียกใช้

โยน
TargetSetupError	if fatal error occurred setting up environment
BuildError	หากเกิดข้อผิดพลาดเนื่องจากกำลังเตรียมบิลด์
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

ทําการล้าง/รื้อถอนเป้าหมายหลังจากการทดสอบ

พารามิเตอร์
testInformation	TestInformation: TestInformation ของการเรียกใช้
e	Throwable: หากการเรียกใช้สิ้นสุดด้วยข้อยกเว้น ข้อยกเว้นนี้จะเป็นข้อยกเว้นที่พบในระดับการเรียกใช้ มิเช่นนั้นจะเป็น null

โยน
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

tearDown

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

วิธีการนี้เลิกใช้งานแล้ว
ใช้ tearDown(com.android.tradefed.invoker.TestInformation, Throwable) แทน

ทําการล้าง/รื้อถอนเป้าหมายหลังจากการทดสอบ

พารามิเตอร์
device	ITestDevice: ITestDevice ที่จะเตรียม
buildInfo	IBuildInfo: ข้อมูลเกี่ยวกับบิลด์ที่ทดสอบ
e	Throwable: หากการเรียกใช้สิ้นสุดด้วยข้อยกเว้น ข้อยกเว้นนี้จะเป็นข้อยกเว้นที่พบในระดับการเรียกใช้ มิเช่นนั้นจะเป็น null

โยน
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง