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

InstallApexModuleTargetPreparer

public class InstallApexModuleTargetPreparer
extends SuiteApkInstaller

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup
		↳	com.android.tradefed.targetprep.suite.SuiteApkInstaller
			↳	com.android.tradefed.targetprep.InstallApexModuleTargetPreparer

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

ModuleOemTargetPreparer

สรุป

ค่าคงที่
`String`	`APEX_OPTION`
`String`	`APEX_SUFFIX`
`String`	`APK_SUFFIX`
`String`	`APK_ZIP_OPTION`
`String`	`CHILD_SESSION_CREATION_CMD`
`String`	`PARENT_SESSION_CREATION_CMD`
`String`	`ROLLBACK_STATE_COMMITTED`
`String`	`ROLLBACK_STATE_UNKNOWN`
`String`	`SPLIT_APKS_SUFFIX`

ช่อง
`protected File`	`mTrainFolderPath`

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

เมธอดสาธารณะ
	`getModulesToInstall(TestInformation testInfo)` รับโมดูลที่ควรติดตั้งในรถไฟ โดยอิงตามโมดูลที่โหลดไว้ล่วงหน้าใน อุปกรณ์
`void`	`setIgnoreIfNotPreloaded(boolean skip)`
`void`	`setSkipApexTearDown(boolean skip)`
`void`	`setUp(TestInformation testInfo)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`

วิธีการที่ได้รับการป้องกัน
`void`	`addApksToTestFiles()`
`void`	`addStagedReadyTimeoutForAdb( cmd)`
`void`	`addTimeoutMillisForBundletool( extraArgs)`
`void`	`checkApexActivation(ITestDevice device)` ตรวจสอบว่าได้เปิดใช้งานยอดทั้งหมดแล้ว
	`collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo)` รวบรวมข้อมูล Apex จากโมดูล Apex เพื่อตรวจสอบการเปิดใช้งาน
	`getApkInstalled()`
`String`	`getBundletoolFileName()`
`BundletoolUtil`	`getBundletoolUtil()`
`String`	`getModuleKeywordFromApexPackageName(String packageName)` รับคีย์เวิร์ด (เช่น "tzdata" สำหรับ com.android.tzdata.apex) จากชื่อแพ็กเกจ Apex
	`getModulesFailToActivate( activatedApexes)` รับโมดูลที่เปิดใช้งานไม่สำเร็จ
	`getSplitsForApks(TestInformation testInfo, File moduleFile)` แยกและแสดงผลการแยกสำหรับ APK ที่ระบุ
`void`	`initBundletoolUtil(TestInformation testInfo)` เริ่มต้นยูทิลิตี bundletool สำหรับคลาสนี้
`void`	`installTrain(TestInformation testInfo, moduleFilenames)` พยายามติดตั้งรถไฟสายหลักที่มี Apex ในอุปกรณ์
`void`	`installUsingBundleTool(TestInformation testInfo, testAppFileNames)` พยายามติดตั้งโมดูล Mainline โดยใช้ Bundletool
`void`	`installer(TestInformation testInfo, testAppFileNames)` พยายามติดตั้งแพ็กเกจหรือแพ็กเกจที่แยกในอุปกรณ์
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` ดึงข้อมูล ApexInfo ซึ่งมี packageName และ versionCode จากไฟล์ Apex ที่ระบุ

ค่าคงที่

APEX_OPTION

protected static final String APEX_OPTION

ค่าคงที่: "--apex"

APEX_SUFFIX

protected static final String APEX_SUFFIX

ค่าคงที่: ".apex"

APK_SUFFIX

protected static final String APK_SUFFIX

ค่าคงที่ ".apk"

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

ค่าคงที่: "--apks-zip"

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

ค่าคงที่: "pm install-create"

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

ค่าคงที่: "pm install-create --multi-package"

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

ค่าคงที่: "committed"

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

ค่าคงที่: "unknown"

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

ค่าคงที่ ".apks"

ช่อง

mTrainFolderPath

protected File mTrainFolderPath

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

InstallApexModuleTargetPreparer

public InstallApexModuleTargetPreparer ()

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

getModulesToInstall

public  getModulesToInstall (TestInformation testInfo)

รับโมดูลที่ควรติดตั้งในรถไฟ โดยอิงตามโมดูลที่โหลดไว้ล่วงหน้าใน อุปกรณ์ ระบบจะไม่ติดตั้งโมดูลที่ไม่ได้โหลดไว้ล่วงหน้า

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation`

คิกรีเทิร์น
	รายการ โมดูลที่ควรติดตั้งในอุปกรณ์

การขว้าง
`DeviceNotAvailableException`	เมื่ออุปกรณ์ไม่พร้อมใช้งาน
`TargetSetupError`	เมื่อไม่ได้ติดตั้งโมดูลที่จำเป็น หรือติดตั้งโมดูลไม่ได้

setIgnoreIfNotPreloaded

public void setIgnoreIfNotPreloaded (boolean skip)

พารามิเตอร์
`skip`	`boolean`

setSkipApexTearDown

public void setSkipApexTearDown (boolean skip)

พารามิเตอร์
`skip`	`boolean`

setUp

public void setUp (TestInformation testInfo)

พารามิเตอร์
`testInfo`	`TestInformation`

การขว้าง
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

พารามิเตอร์
`testInfo`	`TestInformation`
`e`	`Throwable`

การขว้าง
`DeviceNotAvailableException`
`DeviceRuntimeException`

วิธีการที่ได้รับการป้องกัน

addApksToTestFiles

protected void addApksToTestFiles ()

addStagedReadyTimeoutForAdb

protected void addStagedReadyTimeoutForAdb ( cmd)

พารามิเตอร์
`cmd`

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool ( extraArgs)

พารามิเตอร์
`extraArgs`

checkApexActivation

protected void checkApexActivation (ITestDevice device)

ตรวจสอบว่าได้เปิดใช้งานยอดทั้งหมดแล้ว

พารามิเตอร์
`device`	`ITestDevice`: อยู่ระหว่างการทดสอบ

การขว้าง
`TargetSetupError`	หากการเปิดใช้งานล้มเหลว
`DeviceNotAvailableException`

collectApexInfoFromApexModules

protected  collectApexInfoFromApexModules ( testAppFileNames, 
                TestInformation testInfo)

รวบรวมข้อมูล Apex จากโมดูล Apex เพื่อตรวจสอบการเปิดใช้งาน

พารามิเตอร์
`testAppFileNames`	: รายชื่อชื่อไฟล์ของโมดูลที่จะติดตั้ง
`testInfo`	`TestInformation`: `TestInformation`

คิกรีเทิร์น
	รายการที่มี apexinfo ของโมดูล Apex ในรายการไฟล์อินพุต

การขว้าง
`TargetSetupError`

getApkInstalled

protected  getApkInstalled ()

คิกรีเทิร์น

getBundletoolFileName

protected String getBundletoolFileName ()

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

getBundletoolUtil

protected BundletoolUtil getBundletoolUtil ()

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

getModuleKeywordFromApexPackageName

protected String getModuleKeywordFromApexPackageName (String packageName)

รับคีย์เวิร์ด (เช่น "tzdata" สำหรับ com.android.tzdata.apex) จากชื่อแพ็กเกจ Apex

พารามิเตอร์
`packageName`	`String`: ชื่อแพ็กเกจของไฟล์ Apex

คิกรีเทิร์น
`String`	สตริง คีย์เวิร์ดของชื่อแพ็กเกจ Apex

getModulesFailToActivate

protected  getModulesFailToActivate ( activatedApexes)

รับโมดูลที่เปิดใช้งานไม่สำเร็จ

พารามิเตอร์
`activatedApexes`	: ชุดของจุดยอดที่ใช้งานอยู่บนอุปกรณ์

คิกรีเทิร์น
	รายการที่มี apexinfo ของโมดูล Apex อินพุตที่เปิดใช้งานไม่สำเร็จ

การขว้าง
`DeviceNotAvailableException`
`TargetSetupError`

getSplitsForApks

protected  getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

แยกและแสดงผลการแยกสำหรับ APK ที่ระบุ

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation`
`moduleFile`	`File`: ไฟล์โมดูลที่จะแยกการแยก

คิกรีเทิร์น
	File[] ที่มีไฟล์ที่แยก

การขว้าง
`TargetSetupError`	หากไม่พบ Bundletool หรือสร้างไฟล์ข้อมูลจำเพาะของอุปกรณ์ไม่สำเร็จ

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

เริ่มต้นยูทิลิตี bundletool สำหรับคลาสนี้

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation` สำหรับการเรียกใช้

การขว้าง
`TargetSetupError`	หากไม่พบ Bundletool

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames)

พยายามติดตั้งรถไฟสายหลักที่มี Apex ในอุปกรณ์

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation`
`moduleFilenames`	: รายการสตริง รายการชื่อไฟล์ของโมดูลหลักที่จะ ติดตั้ง

การขว้าง
`DeviceNotAvailableException`
`TargetSetupError`

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                 testAppFileNames)

พยายามติดตั้งโมดูล Mainline โดยใช้ Bundletool

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation`
`testAppFileNames`	: ชื่อไฟล์ของโมดูลที่โหลดล่วงหน้าเพื่อติดตั้ง

การขว้าง
`DeviceNotAvailableException`
`TargetSetupError`

โปรแกรมติดตั้ง

protected void installer (TestInformation testInfo, 
                 testAppFileNames)

พยายามติดตั้งแพ็กเกจหรือแพ็กเกจที่แยกในอุปกรณ์

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation` สำหรับการเรียกใช้
`testAppFileNames`	: APK และแพ็กเกจที่จะติดตั้ง

การขว้าง
`DeviceNotAvailableException`
`TargetSetupError`

retrieveApexInfo

protected ITestDevice.ApexInfo retrieveApexInfo (File testApexFile, 
                DeviceDescriptor deviceDescriptor)

ดึงข้อมูล ApexInfo ซึ่งมี packageName และ versionCode จากไฟล์ Apex ที่ระบุ

พารามิเตอร์
`testApexFile`	`File`: ไฟล์ Apex ที่เราดึงข้อมูลจาก
`deviceDescriptor`	`DeviceDescriptor`

คิกรีเทิร์น
`ITestDevice.ApexInfo`	`ApexInfo` ที่มี packageName และ versionCode ของไฟล์ที่ระบุ

การขว้าง
`TargetSetupError`	หากโปรแกรมแยกวิเคราะห์ aapt แยกวิเคราะห์ไฟล์ไม่สำเร็จ