ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาที่เสถียรของ Trunk และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main ในการสร้างและมีส่วนร่วมใน AOSP android-latest-release สาขาไฟล์ Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

BaseTargetPreparer

public abstract class BaseTargetPreparer
extends Object implements ITargetPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer

คลาสย่อยโดยตรงที่ทราบ

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BuildInfoRecorder, CompanionAllocator, CompanionAwarePreparer, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter, CreateAvdPreparer, CreateUserPreparer, DeviceActionTargetPreparer, DeviceBuildInfoBootStrapper และอื่นๆ อีก 59 รายการ

AdbStopServerPreparer	กำหนดเป้าหมายของเครื่องมือเตรียมข้อมูลให้หยุดเซิร์ฟเวอร์ adb ในโฮสต์ก่อนและหลังการเรียกใช้การทดสอบ adb
AllTestAppsInstallSetup	`ITargetPreparer` ที่ติดตั้งแอปทั้งหมดจากโฟลเดอร์ `IDeviceBuildInfo.getTestsDir()` ลงในอุปกรณ์
AoaTargetPreparer	`ITargetPreparer` ที่ดำเนินการชุดการทำงาน (เช่น การคลิกและการปัด) โดยใช้โปรโตคอล Android Open Accessory (AOAv2)
AppSetup	`ITargetPreparer` ที่ติดตั้ง APK และการทดสอบ
ArtChrootPreparer	สร้างไดเรกทอรี chroot สำหรับการทดสอบ ART
BaseEmulatorPreparer	ตัวเตรียมข้อมูลทั่วไปสำหรับการเปิดตัวโปรแกรมจำลองในเครื่อง
BuildInfoRecorder	`ITargetPreparer` ที่เขียนข้อมูลเมตาของข้อมูลการสร้างลงในไฟล์ที่ระบุ
CompanionAllocator	คลาสพื้นฐานที่ดูแลการจัดสรรและยกเลิกการจัดสรรอุปกรณ์คู่ ควรใช้ `getCompanionDeviceSelectionOptions()` เพื่ออธิบายเกณฑ์ ที่จำเป็นในการจัดสรรอุปกรณ์ที่แสดงร่วม
CompanionAwarePreparer	`ITargetPreparer` ที่ห่อหุ้มตรรกะของการรับอุปกรณ์คู่ที่จัดสรรไว้แล้ว
CompileBootImageWithSpeedTargetPreparer	คอมไพล์เส้นทางคลาสการบูตและเซิร์ฟเวอร์ระบบอีกครั้งด้วยตัวกรองคอมไพเลอร์ "speed"
CpuThrottlingWaiter	`ITargetPreparer` ที่รอจนกว่าความถี่สูงสุดในทุกคอร์จะกลับมาเป็นระดับสูงสุดที่พร้อมใช้งาน
CreateAvdPreparer
CreateUserPreparer	TargetPreparer สำหรับสร้างผู้ใช้และล้างข้อมูลเมื่อสิ้นสุด
DeviceActionTargetPreparer	`ITargetPreparer` เพื่อดำเนินการกับอุปกรณ์
DeviceBuildInfoBootStrapper	`ITargetPreparer` ที่แทนที่ฟิลด์ข้อมูลการสร้างด้วยแอตทริบิวต์ที่อ่านจากอุปกรณ์ ซึ่งมีประโยชน์สำหรับการทดสอบอุปกรณ์ที่มีบิลด์ที่สร้างจากแหล่งที่มาภายนอก (เช่น
DeviceBuildInfoInjector	`ITargetPreparer` ที่แทรก`DeviceBuildDescriptor`ข้อมูลเมตาลงใน`IBuildInfo`
DeviceCleaner	รีบูตหรือจัดรูปแบบเป็นดำเนินการล้างข้อมูลหลังการทดสอบ และปิดหน้าจอ (ไม่บังคับ)
DeviceFlashPreparer	`ITargetPreparer` ที่แสดงรูปภาพบนฮาร์ดแวร์ Android จริง
DeviceOwnerTargetPreparer	`ITargetPreparer` ที่ตั้งค่าคอมโพเนนต์เจ้าของอุปกรณ์
DeviceSetup	`ITargetPreparer` ที่กำหนดค่าอุปกรณ์สำหรับการทดสอบตาม `Option` ที่ระบุ
DeviceStorageFiller	กำหนดเป้าหมายผู้เตรียมข้อมูลให้เติมพื้นที่เก็บข้อมูลเพื่อให้มีพื้นที่ว่างจำนวนหนึ่ง
DeviceStringPusher	Target preparer to write a string to a file.
DeviceWiper	`ITargetPreparer` ที่ล้างข้อมูลผู้ใช้
DisableSELinuxTargetPreparer	เครื่องมือเตรียมเป้าหมายที่ปิดใช้ SELinux หากเปิดใช้
DynamicSystemPreparer	`ITargetPreparer` ที่ตั้งค่าอิมเมจระบบบนบิลด์ของอุปกรณ์ด้วยการอัปเดตระบบแบบไดนามิก
EraseUserDataPreparer	`ITargetPreparer` ที่ล้างข้อมูลผู้ใช้ในอุปกรณ์
FastbootCommandPreparer	ตัวเตรียมเป้าหมายที่ทริกเกอร์ Fastboot และส่งคำสั่ง Fastboot
FeatureFlagTargetPreparer	อัปเดต DeviceConfig (ฟีเจอร์แฟล็กที่ปรับแต่งโดยบริการระยะไกล)
FoldableModePreparer	โปรแกรมเตรียมเป้าหมายที่สามารถเปลี่ยนสถานะแบบพับได้ของอุปกรณ์
FolderSaver	`ITargetPreparer` ที่ดึงไดเรกทอรีออกจากอุปกรณ์ บีบอัด และบันทึกลงในแบ็กเอนด์การบันทึก
FutilityCommandPreparer	เตรียมผู้ดำเนินการให้เรียกใช้คำสั่งที่ไม่มีประโยชน์
GkiDeviceFlashPreparer	เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยรูปภาพทั่วไปของเคอร์เนลทั่วไปของ Android
GsiDeviceFlashPreparer	เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยอิมเมจระบบทั่วไปของ Android
InstallAllTestZipAppsSetup	`ITargetPreparer` ที่ติดตั้งแอปทั้งหมดใน ZIP สำหรับทดสอบ
InstallApkSetup	`ITargetPreparer` ที่ติดตั้ง APK อย่างน้อย 1 รายการซึ่งอยู่ในระบบไฟล์
InstallBuildEnvApkSetup	`ITargetPreparer` ที่ติดตั้ง APK สำหรับทดสอบอย่างน้อย 1 รายการจากสภาพแวดล้อมการสร้างแพลตฟอร์ม Android
InstallKernelModulePreparer	เครื่องมือเตรียมเป้าหมายที่ติดตั้งโมดูลเคอร์เนล
InstrumentationPreparer	`ITargetPreparer` ที่เรียกใช้การวัดประสิทธิภาพ
KillExistingEmulatorPreparer	`ITargetPreparer` ที่ปิดโปรแกรมจำลองที่กำลังทำงานอยู่
KnownFailurePreparer	กำหนดเป้าหมายผู้เตรียมข้อมูลให้ข้ามการลองใหม่เมื่อทราบว่าไม่สำเร็จ
MixKernelTargetPreparer	`ITargetPreparer` ที่อนุญาตให้รวมรูปภาพเคอร์เนลกับรูปภาพอุปกรณ์
MixRadioTargetPreparer	`ITargetPreparer` ที่อนุญาตให้ผสมรูปภาพวิทยุกับรูปภาพอุปกรณ์
NativeLeakCollector	`ITargetPreparer` ที่เรียกใช้ "dumpsys meminfo --unreachable -a" เพื่อระบุ หน่วยความจำเนทีฟที่เข้าถึงไม่ได้ซึ่งแต่ละกระบวนการถือครองอยู่ในปัจจุบัน
NoApkTestSkipper	Special preparer ที่อนุญาตให้ข้ามการเรียกใช้ทั้งหมด (การเตรียมและการทดสอบ) หากไม่มี APK ที่จะทดสอบ
PerfettoPreparer	เครื่องมือเตรียม Perfetto จะพุชไฟล์การกำหนดค่าไปยังอุปกรณ์ในตำแหน่งมาตรฐานที่ Perfetto มีสิทธิ์เข้าถึง
ProfileTargetPreparer	คลาสพื้นฐานสำหรับการตั้งค่าเครื่องมือเตรียมเป้าหมายสำหรับผู้ใช้โปรไฟล์ `android.os.usertype.profile.XXX`
PushFilePreparer	`ITargetPreparer` ที่พยายามส่งไฟล์จำนวนเท่าใดก็ได้จากเส้นทางโฮสต์ไปยังเส้นทางอุปกรณ์
PythonVirtualenvPreparer	ตั้งค่าสภาพแวดล้อมเสมือนของ Python ในโฮสต์และติดตั้งแพ็กเกจ
RebootTargetPreparer	ผู้เตรียมเป้าหมายที่รีบูตอุปกรณ์
RecoveryLogPreparer	เครื่องมือเตรียมข้อมูลเป้าหมายที่ใช้รวบรวมบันทึกก่อนการกู้คืน
RemoveSystemAppPreparer	`ITargetPreparer` สำหรับการนำ APK ออกจากพาร์ติชันของระบบก่อนการทดสอบ
RestartSystemServerTargetPreparer	Target Preparer ที่รีสตาร์ทเซิร์ฟเวอร์ระบบโดยไม่ต้องรีบูตอุปกรณ์
RootTargetPreparer	Target preparer ที่ดำเนินการ "adb root" หรือ "adb unroot" ตามตัวเลือก "force-root"
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	กำหนดเป้าหมายผู้เตรียมการให้เรียกใช้คำสั่งโฮสต์ที่กำหนดเองก่อนและหลังการทดสอบ
RunHostScriptTargetPreparer	กำหนดเป้าหมายตัวเตรียมที่จะเรียกใช้สคริปต์ก่อนเรียกใช้การทดสอบ
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` เพื่อทำเครื่องหมายว่าการทดสอบควรทำงานในแซนด์บ็อกซ์ SDK
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` เพื่อให้แน่ใจว่าการทดสอบจะทำงานในฐานะผู้ใช้รอง
RunOnSystemUserTargetPreparer	`ITargetPreparer` ที่ระบุว่าควรทำการทดสอบกับผู้ใช้ (แทนที่จะเป็นผู้ใช้ปัจจุบัน)
SemaphoreTokenTargetPreparer	นี่คือตัวเตรียมที่ใช้โทเค็นเพื่อจัดลำดับการดำเนินการทดสอบในโฮสต์ Tradefed
StopServicesSetup	`ITargetPreparer` ที่หยุดบริการในอุปกรณ์
StubTargetPreparer	การติดตั้งใช้งาน `ITargetPreparer` ที่ว่างเปล่าของตัวยึดตำแหน่ง
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` ได้หากไม่ได้ตั้งค่าวันที่และเวลาภายใน การหมดเวลา
WifiPreparer	`ITargetPreparer` ที่กำหนดค่า Wi-Fi ในอุปกรณ์หากจำเป็น

คลาสย่อยทางอ้อมที่ทราบ

CheckPairingPreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, DeviceImageZipFlashingTargetPreparer, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, GoogleAccountPreparer, InstallApexModuleTargetPreparer, LocalEmulatorLaunch, LocalEmulatorSnapshot, ModuleOemTargetPreparer, PushFileInvoker, RunOnCloneProfileTargetPreparer, RunOnPrivateProfileTargetPreparer, RunOnWorkProfileTargetPreparer, SideloadOtaTargetPreparer, SuiteApkInstaller

CheckPairingPreparer	`CompanionAwarePreparer` ที่ยืนยันการจับคู่ BT ระหว่างอุปกรณ์หลักและอุปกรณ์เสริม
CompanionRunCommandTargetPreparer	`ITargetPreparer` ที่เรียกใช้คำสั่งที่ระบุในอุปกรณ์คู่ที่จัดสรร
CompanionTestAppInstallSetup	`ITargetPreparer` ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ `IDeviceBuildInfo.getTestsDir()` ลงในอุปกรณ์คู่ที่จัดสรรไว้
DeviceImageZipFlashingTargetPreparer	เครื่องมือเตรียมเป้าหมายที่แฟลชอุปกรณ์ด้วยรูปภาพอุปกรณ์ที่ระบุผ่านรูปแบบที่เฉพาะเจาะจง
DeviceUpdateTargetPreparer	`ITargetPreparer` ที่จัดการขั้นตอนทั่วไปเกี่ยวกับการอัปเดตอุปกรณ์ด้วย ไฟล์อิมเมจของอุปกรณ์จากแหล่งที่มาภายนอก (ซึ่งต่างจากบริการบิลด์)
FastbootUpdateBootstrapPreparer	`ITargetPreparer` ที่จัดเตรียมไฟล์ที่ระบุ (bootloader, radio, device image zip) ลงใน `IDeviceBuildInfo` เพื่อให้อุปกรณ์แฟลชด้วย `FastbootDeviceFlasher` จากนั้นจะแทรก แอตทริบิวต์ของอุปกรณ์หลังการบูตลงในข้อมูลการสร้างเพื่อวัตถุประสงค์ในการรายงานผล
GoogleAccountPreparer	`ITargetPreparer` ที่รองรับการกำหนดค่าบัญชี Google
InstallApexModuleTargetPreparer
LocalEmulatorLaunch	TargetPreparer ที่เปิดตัวโปรแกรมจำลองในเครื่องจากสภาพแวดล้อมการสร้าง Android
LocalEmulatorSnapshot	TargetPreparer มีไว้เพื่อสร้างสแนปชอตของโปรแกรมจำลองที่สะอาดจากสภาพแวดล้อมการสร้าง/พัฒนา Android
ModuleOemTargetPreparer
PushFileInvoker	คลาสนี้เลิกใช้งานแล้ว โปรดใช้ `PushFilePreparer` แทน
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnWorkProfileTargetPreparer	`ITargetPreparer` ที่สร้างโปรไฟล์งานในการตั้งค่า และทำเครื่องหมายว่าควรเรียกใช้การทดสอบในผู้ใช้รายนั้น
SideloadOtaTargetPreparer	เครื่องมือเตรียมเป้าหมายที่ทำการโหลดด้านข้างของแพ็กเกจ OTA ที่ระบุ ใช้แพ็กเกจ รอ ให้อุปกรณ์บูตขึ้น และแทรกพร็อพเพอร์ตี้บิลด์ของอุปกรณ์เพื่อใช้เป็นข้อมูลบิลด์ ตัวเตรียมเป้าหมายนี้ถือว่าอุปกรณ์จะอยู่ในโหมด adb ปกติเมื่อเริ่มต้น และ จะตรวจสอบว่าอุปกรณ์ออกจากโหมดเดียวกันแต่ใช้บิลด์ใหม่กว่า
SuiteApkInstaller	ติดตั้ง APK ที่ระบุสำหรับการกำหนดค่า Suite ไม่ว่าจะมาจากตัวแปร $ANDROID_TARGET_OUT_TESTCASES หรือ ROOT_DIR ในข้อมูลการสร้าง

คลาสการติดตั้งใช้งานพื้นฐานสำหรับ ITargetPreparer ที่ช่วยให้ควบคุมได้ว่าจะปิดใช้ออบเจ็กต์ หรือไม่

สรุป

เครื่องมือสร้างสาธารณะ
`BaseTargetPreparer()`

เมธอดสาธารณะ
`final boolean`	`isDisabled()` แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล)
`final boolean`	`isTearDownDisabled()` แสดงค่า True หากควรข้ามการล้างข้อมูล
`final void`	`setDisable(boolean isDisabled)` กำหนดว่าควรปิดใช้วัตถุหรือไม่
`final void`	`setDisableTearDown(boolean isDisabled)` กำหนดว่าจะข้ามขั้นตอนการแยกชิ้นส่วนในออบเจ็กต์หรือไม่

เครื่องมือสร้างสาธารณะ

BaseTargetPreparer

public BaseTargetPreparer ()

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

isDisabled

public final boolean isDisabled ()

แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล) มิเช่นนั้นจะเป็น "เท็จ"

คิกรีเทิร์น
`boolean`

isTearDownDisabled

public final boolean isTearDownDisabled ()

แสดงค่า True หากควรข้ามการล้างข้อมูล มิเช่นนั้นจะเป็น "เท็จ"

คิกรีเทิร์น
`boolean`

setDisable

public final void setDisable (boolean isDisabled)

กำหนดว่าควรปิดใช้วัตถุหรือไม่ ปิดใช้หมายความว่าควรข้ามทั้งขั้นตอนการตั้งค่าและการสิ้นสุด ใช้เพื่อทำให้ออบเจ็กต์ปิดใช้โดยค่าเริ่มต้นในตัวสร้างเริ่มต้นได้

พารามิเตอร์
`isDisabled`	`boolean`: สถานะที่ควรใช้กับออบเจ็กต์

setDisableTearDown

public final void setDisableTearDown (boolean isDisabled)

กำหนดว่าจะข้ามขั้นตอนการแยกชิ้นส่วนในออบเจ็กต์หรือไม่ ขั้นตอนการตั้งค่ายังคงดำเนินการอยู่

พารามิเตอร์
`isDisabled`	`boolean`: สถานะที่ควรใช้กับออบเจ็กต์