ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

คลาสย่อยโดยอ้อมที่รู้จัก AdbStopServerServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoContainer, Companion.Measure Preparer BuildInfoPreparer, Companion.Target2เดินทาง{/17 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  เครื่องมือเตรียมเครื่องมือ 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" ตามตัวเลือก "force-root"  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	หากอุปกรณ์ไม่ตอบสนอง