ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

คลาสย่อยโดยอ้อมที่รู้จัก AdbStopServerPreparer ตัวเตรียมเป้าหมายเพื่อหยุดเซิร์ฟเวอร์ adb ในโฮสต์ก่อนและหลังการทดสอบ adb  การตั้งค่า AllTestAppsInstall ITargetPreparer ที่ติดตั้งแอปทั้งหมดจาก IDeviceBuildInfo#getTestsDir() ลงในอุปกรณ์  AoaTargetPreparer ITargetPreparer ที่ดำเนินการชุดการดำเนินการ (เช่น การคลิกและการเลื่อน) โดยใช้ โปรโตคอล Android Open Accessory (AOAv2)  การตั้งค่าแอป ITargetPreparer ที่ติดตั้ง APK และการทดสอบ  ArtChrootPreparer สร้างไดเรกทอรี chroot สำหรับการทดสอบ ART  BaseEmulatorPreparer การเตรียมพร้อมโดยทั่วไปสำหรับการเปิดตัวโปรแกรมจำลองในเครื่อง  BaseTargetPreparer คลาสการใช้งานฐานสำหรับ ITargetPreparer ที่อนุญาตให้ควบคุมว่าออบเจ็กต์ ปิดใช้งานอยู่หรือไม่  BuildInfoRecorder ITargetPreparer ที่เขียนข้อมูลเมตาของข้อมูลของบิลด์ลงในไฟล์ที่ระบุ  เครื่องมือตรวจสอบการจับคู่ CompanionAwarePreparer ที่ยืนยันการเชื่อมโยง BT ระหว่างอุปกรณ์หลักและอุปกรณ์ที่ใช้ร่วมกัน CompanionAllocator คลาสพื้นฐานที่ดูแลการจัดสรรและเพิ่มพื้นที่ว่างในอุปกรณ์ที่ใช้ร่วมกัน ควรใช้ getCompanionDeviceSelectionOptions() เพื่ออธิบายเกณฑ์ ที่จำเป็นต่อการจัดสรรอุปกรณ์ที่ใช้ร่วมกัน CompanionAwarePreparer ITargetPreparer ที่สรุปตรรกะของการแสดงร่วมที่จัดสรรแล้ว อุปกรณ์  CompanionRunCommandTargetPreparer ITargetPreparer ที่เรียกใช้คำสั่งที่ระบุในอุปกรณ์ที่ใช้ร่วมกันที่จัดสรรไว้ ตั้งค่า CompanionTestAppInstall ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจาก IDeviceBuildInfo#getTestsDir() โฟลเดอร์ลงในอุปกรณ์ที่ใช้ร่วมกันที่จัดสรรไว้  CompileBootImageWithSpeedTargetPreparer คอมไพล์คลาสพาธการเปิดเครื่องและเซิร์ฟเวอร์ระบบอีกครั้งโดยใช้ตัวกรอง "ความเร็ว" ของคอมไพเลอร์  CpuThrottlingWaiter ITargetPreparer ที่รอจนกว่าจะมีการคืนค่าความถี่สูงสุดในแกนทั้งหมดกลับสู่ค่าสูงสุด ระดับที่ใช้ได้ CreateAvdPreparer   CreateUserPreparer ตัวเตรียมเป้าหมายสำหรับการสร้างผู้ใช้และล้างข้อมูลในตอนท้าย  DeviceActionTargetPreparer ITargetPreparer สำหรับการดำเนินการของอุปกรณ์  DeviceBuildInfoBootStrapper ITargetPreparer ที่แทนที่ช่องข้อมูลของบิลด์ด้วยแอตทริบิวต์ที่อ่านจากอุปกรณ์ วิธีนี้มีประโยชน์สำหรับการทดสอบอุปกรณ์ที่มีบิลด์ที่สร้างจากแหล่งที่มาภายนอก (เช่น DeviceBuildInfoInjector ITargetPreparer ที่แทรกข้อมูลเมตา DeviceBuildDescriptor ลงใน IBuildInfo  เครื่องมือทำความสะอาดอุปกรณ์ รีบูตหรือฟอร์แมตเป็นการดำเนินการล้างข้อมูลหลังจากการทดสอบ และเลือกปิดหน้าจอได้ DeviceFlashPreparer ITargetPreparer ที่แสดงรูปภาพบนฮาร์ดแวร์ Android ที่จับต้องได้  DeviceImageZipFlashingTargetPreparer เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยรูปภาพอุปกรณ์ที่ให้ไว้ผ่านรูปแบบเฉพาะ  DeviceOwnerTargetPreparer ITargetPreparer ที่ตั้งค่าคอมโพเนนต์เจ้าของอุปกรณ์  การตั้งค่าอุปกรณ์ ITargetPreparer ที่กำหนดค่าอุปกรณ์สำหรับการทดสอบตาม Option ที่ให้ไว้  DeviceStorageFiller เครื่องมือเตรียมเป้าหมายที่จะเต็มพื้นที่เก็บข้อมูลเพื่อเพิ่มพื้นที่ว่างบางส่วน  DeviceStringPusher ตัวเตรียมเป้าหมายเพื่อเขียนสตริงลงในไฟล์  DeviceUpdateTargetPreparer ภาพนามธรรม ITargetPreparer ที่จัดการขั้นตอนทั่วไปในการอัปเดตอุปกรณ์ด้วย ไฟล์ภาพของอุปกรณ์จากแหล่งที่มาภายนอก (แทนที่จะเป็นบริการบิลด์)  ที่ปัดน้ำฝนอุปกรณ์ ITargetPreparer ที่ล้างข้อมูลผู้ใช้ ปิดการใช้งานSELinuxTargetPreparer ตัวเตรียมเป้าหมายที่จะปิดใช้ SELinux หากเปิดใช้  DynamicSystemPreparer ITargetPreparer ที่ตั้งค่าอิมเมจระบบที่ด้านบนของบิลด์ของอุปกรณ์ด้วย การอัปเดตระบบ  DeleteUserDataPreparer ITargetPreparer ที่ล้างข้อมูลผู้ใช้ในอุปกรณ์  FastbootCommandPreparer ตัวเตรียมการเป้าหมายที่เรียกใช้ Fastboot และส่งคำสั่ง Fastboot  FastbootUpdateBootstrapPreparer ITargetPreparer ที่เก็บพักไฟล์ที่ระบุ (bootloader, วิทยุ, ไฟล์ ZIP รูปภาพของอุปกรณ์) ลงใน IDeviceBuildInfo เพื่อทำให้อุปกรณ์กะพริบด้วย FastbootDeviceFlasher แล้วแทรก แอตทริบิวต์อุปกรณ์หลังเปิดเครื่องลงในข้อมูลบิลด์เพื่อวัตถุประสงค์ในการรายงานผลลัพธ์  FeatureFlagTargetPreparer อัปเดต DeviceConfig (แฟล็กฟีเจอร์ที่ปรับแต่งโดยบริการระยะไกล)  FoldableModePreparer เครื่องมือเตรียมเป้าหมายที่สามารถเปลี่ยนสถานะอุปกรณ์แบบพับได้  ตัวบันทึกโฟลเดอร์ ITargetPreparer ที่ดึงไดเรกทอรีออกจากอุปกรณ์ บีบอัด และบันทึกไว้ในการบันทึก แบ็กเอนด์  GkiDeviceFlashPreparer เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยอิมเมจทั่วไปของเคอร์เนลทั่วไปของ Android  GsiDeviceFlashPreparer เครื่องมือเตรียมเป้าหมายที่จะแฟลชอุปกรณ์ด้วยอิมเมจระบบทั่วไปของ Android  ผู้เตรียมสอบ ILab อินเทอร์เฟซตัวทำเครื่องหมายสำหรับเครื่องเตรียมห้องทดลอง โปรดดู ITargetPreparer สำหรับคำอธิบายว่าอินเทอร์เฟซเหล่านี้มีจุดประสงค์อย่างไร  ITargetCleaner อินเทอร์เฟซนี้เลิกใช้งานแล้ว tearDown ย้ายไปยังอินเทอร์เฟซ ITargetPreparer พื้นฐานแล้ว  ตั้งค่าInstallAllTestZipApps ITargetPreparer ที่ติดตั้งแอปทั้งหมดเป็นไฟล์ ZIP ทดสอบ  InstallApexModuleTargetPreparer   ตั้งค่าการติดตั้ง APK ITargetPreparer ที่ติดตั้ง APK อย่างน้อย 1 รายการที่อยู่ในระบบไฟล์  ตั้งค่าInstallBuildEnvApk ITargetPreparer ที่ติดตั้ง APK ทดสอบอย่างน้อย 1 รายการจาก env ของแพลตฟอร์ม Android  InstallKernelModulePreparer เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยอิมเมจทั่วไปของเคอร์เนลทั่วไปของ Android  เครื่องมือเตรียมเครื่องมือ ITargetPreparer ที่เรียกใช้การวัด KillexistingEmulatorPreparer ITargetPreparer ที่จะปิดโปรแกรมจำลองที่ทำงานอยู่  knownFailurePreparer ตัวเตรียมเป้าหมายที่จะข้ามการลองซ้ำความล้มเหลวที่ทราบ  LocalEmulatorLaunch TargetPreparer ที่เปิดโปรแกรมจำลองภายในจากสภาพแวดล้อมบิลด์ของ Android  LocalEmulatorSnapshot TargetPreparer ตั้งใจสร้างสแนปชอตโปรแกรมจำลองที่ชัดเจนจาก Android สภาพแวดล้อมของบิลด์/การพัฒนา MixKernelTargetPreparer ITargetPreparer ที่อนุญาตให้ผสมอิมเมจเคอร์เนลกับอิมเมจของอุปกรณ์  ModuleOemTargetPreparer   เครื่องมือเก็บข้อมูลการรั่วไหลของระบบ ITargetPreparer ที่เรียกใช้ "dumpsys meminfo --unreachable -a" เพื่อระบุ หน่วยความจำดั้งเดิมที่เข้าถึงไม่ได้ที่เก็บรักษาไว้ในกระบวนการแต่ละรายการ  NoApkTestSkipper ผู้เตรียมพร้อมพิเศษที่อนุญาตให้ข้ามการเรียกใช้ไปเลย (การเตรียมตัวและการทดสอบ) หากมี ไม่ใช่ APK ในการทดสอบ  PerfettoPreparer ตัวเตรียม Perfetto จะพุชไฟล์การกำหนดค่าเข้าไปในอุปกรณ์ในตำแหน่งมาตรฐาน Perfetto มีสิทธิ์เข้าถึง  ProfileTargetPreparer คลาสพื้นฐานสำหรับการตั้งค่าตัวเตรียมเป้าหมายสำหรับผู้ใช้โปรไฟล์ android.os.usertype.profile.XXX  PushFileInvoker เลิกใช้งานชั้นเรียนนี้แล้ว ใช้ PushFilePreparer แทน PushFilePreparer ITargetPreparer ที่พยายามพุชไฟล์จำนวนเท่าใดก็ได้จากเส้นทางของโฮสต์ไปยัง เส้นทางอุปกรณ์  PythonVirtualenvPreparer ตั้งค่า Python Virtualenv ในโฮสต์และติดตั้งแพ็กเกจ  รีบูตTargetPreparer เครื่องมือเตรียมเป้าหมายที่รีบูตอุปกรณ์  RecoveryLogPreparer เครื่องมือเตรียมเป้าหมายที่ใช้เพื่อรวบรวมบันทึกก่อนการกู้คืน  RemoveSystemAppPreparer ITargetPreparer สำหรับการนำ APK ออกจากพาร์ติชันระบบก่อนทำการทดสอบ  RestartSystemServerTargetPreparer ตัวเตรียมเป้าหมายที่รีสตาร์ทเซิร์ฟเวอร์ระบบโดยไม่ต้องรีบูตอุปกรณ์  RootTargetPreparer ตัวเตรียมเป้าหมายที่ดำเนินการ "adb root" หรือ "adb unroot" ขึ้นอยู่กับตัวเลือก "ฐานราก"  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetPreparer ตัวเตรียมเป้าหมายในการเรียกใช้คำสั่งของโฮสต์ที่กำหนดเองก่อนและหลังการทดสอบ  RunHostScriptTargetPreparer ตัวเตรียมเป้าหมายที่จะเรียกใช้สคริปต์ก่อนทำการทดสอบ  RunOnClonProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer เพื่อทำเครื่องหมายว่าการทดสอบควรทำงานในแซนด์บ็อกซ์ของ SDK  RunOnsecondaryUserTargetPreparer ITargetPreparer เพื่อให้มั่นใจว่าการทดสอบจะทำงานในฐานะผู้ใช้รอง  RunOnSystemUserTargetPreparer ITargetPreparer ที่ทําเครื่องหมายว่าการทดสอบควรทํางานกับผู้ใช้ (ไม่ใช่ ผู้ใช้ปัจจุบัน)  RunOnWorkProfileTargetPreparer ITargetPreparer ที่สร้างโปรไฟล์งานในการตั้งค่า และทำเครื่องหมายการทดสอบที่ควรจะเป็น ในผู้ใช้รายนั้น  SemaphoreTokenTargetPreparer นี่คือเครื่องมือเตรียมที่ใช้โทเค็นเพื่อเรียงลำดับการยกเว้นการทดสอบในโฮสต์ที่มีการแลกเปลี่ยน  SideloadOtaTargetPreparer เครื่องมือเตรียมเป้าหมายที่ดำเนินการไซด์โหลดของแพ็กเกจ OTA ที่ระบุ ใช้แพ็กเกจ และรอ สำหรับอุปกรณ์เปิดเครื่อง และแทรกพร็อพเพอร์ตี้บิลด์ของอุปกรณ์เพื่อใช้เป็นข้อมูลบิลด์ ตัวเตรียมเป้าหมายนี้จะสมมติว่าอุปกรณ์จะอยู่ในโหมด adb ปกติเมื่อเริ่มต้น และ ช่วยให้มั่นใจได้ว่าอุปกรณ์จะออกจากโหมดเดียวกัน แต่มีการใช้บิลด์ที่ใหม่กว่า  การตั้งค่า StopServices ITargetPreparer ที่หยุดให้บริการในอุปกรณ์  StubTargetPreparer ตัวยึดตำแหน่งใช้งาน ITargetPreparer ว่างเปล่า  โปรแกรมติดตั้ง SuiteApk การติดตั้ง APK ที่ระบุสำหรับการกำหนดค่า Suite: จาก $ANDROID_TARGET_OUT_TESTCASES หรือ ROOT_DIR ในข้อมูลบิลด์ SwitchUserTargetPreparer ITargetPreparer ที่เปลี่ยนเป็นประเภทผู้ใช้ที่ระบุในการตั้งค่า  TearDownPassThroughPreparer อนุญาตให้เรียกใช้ tearDown ในเครื่องมือเตรียมการที่รวมอยู่ในการกำหนดค่าเป็นออบเจ็กต์  TemperatureThrottlingWaiter ITargetPreparerที่รอจนกว่าอุณหภูมิของอุปกรณ์ลดลงถึงเป้าหมาย ตั้งค่าการติดตั้ง TestApp ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในอุปกรณ์  ตั้งค่า TestFilePush ITargetPreparer ที่พุชไฟล์/ไดเรกทอรีอย่างน้อย 1 รายการจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ไปยังอุปกรณ์  TestSystemAppInstallSetup ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในพาร์ติชัน /system ในอุปกรณ์  กาลเวลา เครื่องมือเตรียมเป้าหมายที่ใช้งานง่ายเพื่อให้สิ้นเปลืองเวลาและมีโอกาสรีสตาร์ทอุปกรณ์  UserCleaner ITargetPreparer ที่นำผู้ใช้รองออกเมื่อเลิกใช้งาน  VisibleBackgroundUserPreparer ตัวเตรียมเป้าหมายเพื่อทำการทดสอบในผู้ใช้ที่เริ่มการทำงานในเบื้องหลัง  WaitForDeviceDatetimePreparer ITargetPreparerที่รอการตั้งค่าวันที่และเวลาในอุปกรณ์ (ไม่บังคับ) เครื่องมือเตรียมนี้สามารถบังคับ TargetSetupError หากไม่ได้ตั้งค่าวันที่และเวลาไว้ภายใน หมดเวลา  เครื่องมือเตรียม Wi-Fi 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) แทน

วิธีการสาธารณะ

ตั้งค่า

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

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

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

การขว้าง
TargetSetupError	หากเกิดข้อผิดพลาดร้ายแรงขณะตั้งค่าสภาพแวดล้อม
BuildError	หากข้อผิดพลาดที่เกี่ยวข้องกับ BuildInfo เกิดขึ้น
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

ตั้งค่า

public void setUp (TestInformation testInformation)

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

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

การขว้าง
TargetSetupError	หากเกิดข้อผิดพลาดร้ายแรงขณะตั้งค่าสภาพแวดล้อม
BuildError	หากมีข้อผิดพลาดเกิดขึ้นเนื่องจากกำลังจัดเตรียมบิลด์
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

ฉีกขาด

public void tearDown (TestInformation testInformation, 
                Throwable e)

ดำเนินการล้าง/ทำลายเป้าหมายหลังการทดสอบ

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

การขว้าง
DeviceNotAvailableException	หากอุปกรณ์ไม่ตอบสนอง

ฉีกขาด

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	หากอุปกรณ์ไม่ตอบสนอง