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

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

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

CompanionTestAppInstallSetup, SuiteApkInstaller

CompanionTestAppInstallSetup	`ITargetPreparer` ที่ติดตั้งแอปอย่างน้อย 1 แอปจากโฟลเดอร์ `IDeviceBuildInfo.getTestsDir()` ลงในอุปกรณ์คู่ที่จัดสรรไว้
SuiteApkInstaller	ติดตั้ง APK ที่ระบุสำหรับการกำหนดค่า Suite ไม่ว่าจะมาจากตัวแปร $ANDROID_TARGET_OUT_TESTCASES หรือ ROOT_DIR ในข้อมูลการสร้าง

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

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

ITargetPreparer ที่ติดตั้งแอปอย่างน้อย 1 รายการจากโฟลเดอร์ IDeviceBuildInfo.getTestsDir() ลงในอุปกรณ์

เครื่องมือเตรียมนี้จะค้นหาในไดเรกทอรีอื่นหากไม่มีไฟล์ ZIP ของการทดสอบหรือไม่มี APK ที่จำเป็น การค้นหาจะดำเนินการตามลำดับจากไดเรกทอรีสำรองสุดท้ายที่ระบุไปจนถึงไดเรกทอรีแรก

สรุป

ช่อง
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

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

เมธอดสาธารณะ
`void`	`addInstallArg(String arg)` เพิ่มอาร์กิวเมนต์การติดตั้ง apk 1 รายการที่จะใช้
`void`	`addSplitApkFileNames(String fileNames)` เพิ่มชุดชื่อไฟล์ที่คั่นด้วย "," ในสตริงเพื่อติดตั้งเป็น APK แบบแยก
`void`	`addTestFile(File file)` เพิ่มไฟล์หรือไดเรกทอรีลงในรายการ APK ที่จะติดตั้ง
`void`	`addTestFileName(String fileName)` เพิ่มชื่อไฟล์ลงในรายการ APK ที่จะติดตั้ง
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` แสดงอุปกรณ์ที่ผู้เตรียมควรใช้
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` แสดงผลสำเนาของรายการชื่อ APK ของการทดสอบที่ระบุ
`boolean`	`isCleanUpEnabled()` แสดงค่า True หากจะล้างข้อมูล APK ระหว่างการหยุดทำงาน
`final boolean`	`isInstantMode()` แสดงว่าเปิดใช้การติดตั้งโหมดทันทีหรือไม่
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` ตั้งค่าเวอร์ชันของ AAPT สำหรับการแยกวิเคราะห์ APK
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` ตั้งค่าไดเรกทอรีอื่น
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` กำหนดลักษณะการทำงานของไดเรกทอรีอื่น
`void`	`setCleanApk(boolean shouldClean)` กำหนดว่าจะล้าง apk ที่ติดตั้งใน tearDown หรือไม่
`void`	`setForceQueryable(boolean forceQueryable)` ค่าเริ่มต้นของ force queryable คือ true
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` กำหนดว่าจะเปิดใช้การตั้งค่าแบบเพิ่มทีละรายการในเครื่องมือเตรียม TradeFed หรือไม่
`final void`	`setInstantMode(boolean mode)` กำหนดว่าจะใช้ --instant หรือไม่เมื่อติดตั้ง APK
`void`	`setShouldGrantPermission(boolean shouldGrant)` หากระบุ userId คุณจะตั้งค่า grantPermission สำหรับการติดตั้ง APK ได้
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` เลิกใช้เมธอดนี้แล้ว การเรียกกลับที่เข้ากันได้แบบย้อนหลังชั่วคราว
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` หากควรติดตั้ง APK สำหรับผู้ใช้รายใดรายหนึ่ง ให้ตั้งค่ารหัสของผู้ใช้ที่จะติดตั้ง
`void`	`tearDown(TestInformation testInfo, Throwable e)`

วิธีการที่ได้รับการป้องกัน
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` แก้ไขเส้นทาง APK จริงตามข้อมูลอาร์ติแฟกต์การทดสอบภายในข้อมูลการสร้าง
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` พยายามติดตั้งแพ็กเกจหรือแพ็กเกจที่แยกในอุปกรณ์
`String`	`parsePackageName(File testAppFile)` ดูชื่อแพ็กเกจจากแอปทดสอบ
	`resolveApkFiles(TestInformation testInfo, apkFiles)` Helper to resolve some apk to their File and Package.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` พยายามนำแพ็กเกจออกจากอุปกรณ์

ช่อง

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

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

TestAppInstallSetup

public TestAppInstallSetup ()

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

addInstallArg

public void addInstallArg (String arg)

เพิ่มอาร์กิวเมนต์การติดตั้ง apk 1 รายการที่จะใช้

พารามิเตอร์
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

เพิ่มชุดชื่อไฟล์ที่คั่นด้วย "," ในสตริงเพื่อติดตั้งเป็น APK แบบแยก

พารามิเตอร์
`fileNames`	`String`: สตริงของชื่อไฟล์ที่คั่นด้วย ","

addTestFile

public void addTestFile (File file)

เพิ่มไฟล์หรือไดเรกทอรีลงในรายการ APK ที่จะติดตั้ง

พารามิเตอร์
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

เพิ่มชื่อไฟล์ลงในรายการ APK ที่จะติดตั้ง

พารามิเตอร์
`fileName`	`String`

getAbi

public IAbi getAbi ()

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

getDevice

public ITestDevice getDevice ()

แสดงอุปกรณ์ที่ผู้เตรียมควรใช้

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

การขว้าง
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

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

getTestsFileName

public  getTestsFileName ()

แสดงผลสำเนาของรายการชื่อ APK ของการทดสอบที่ระบุ

คิกรีเทิร์น

isCleanUpEnabled

public boolean isCleanUpEnabled ()

แสดงค่า True หากจะล้างข้อมูล APK ระหว่างการหยุดทำงาน

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

isInstantMode

public final boolean isInstantMode ()

แสดงว่าเปิดใช้การติดตั้งโหมดทันทีหรือไม่

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

reportDependencies

public  reportDependencies ()

คิกรีเทิร์น

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

ตั้งค่าเวอร์ชันของ AAPT สำหรับการแยกวิเคราะห์ APK

พารามิเตอร์
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

พารามิเตอร์
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

ตั้งค่าไดเรกทอรีอื่น

พารามิเตอร์
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

กำหนดลักษณะการทำงานของไดเรกทอรีอื่น

พารามิเตอร์
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

กำหนดว่าจะล้าง apk ที่ติดตั้งใน tearDown หรือไม่

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

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

ค่าเริ่มต้นของ force queryable คือ true อัปเดตเป็น false หากไม่ควรค้นหา apk ที่จะติดตั้ง

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

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

กำหนดว่าจะเปิดใช้การตั้งค่าแบบเพิ่มทีละรายการในเครื่องมือเตรียม TradeFed หรือไม่

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

setInstantMode

public final void setInstantMode (boolean mode)

กำหนดว่าจะใช้ --instant หรือไม่เมื่อติดตั้ง APK จะไม่มีผลหากตั้งค่า force-install-mode

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

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

หากระบุ userId คุณจะตั้งค่า grantPermission สำหรับการติดตั้ง APK ได้

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

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

เลิกใช้เมธอดนี้แล้ว
การเรียกกลับชั่วคราวที่เข้ากันได้แบบย้อนหลัง

พารามิเตอร์
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

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

setUp

public void setUp (TestInformation testInfo)

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

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

setUserId

public void setUserId (int userId)

หากควรติดตั้ง APK สำหรับผู้ใช้รายใดรายหนึ่ง ให้ตั้งค่ารหัสของผู้ใช้ที่จะติดตั้ง

พารามิเตอร์
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

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

การขว้าง
`DeviceNotAvailableException`

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

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

แก้ไขเส้นทาง APK จริงตามข้อมูลอาร์ติแฟกต์การทดสอบภายในข้อมูลการสร้าง

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation` สำหรับการเรียกใช้
`apkFileName`	`String`: ชื่อไฟล์ของ APK ที่จะติดตั้ง

คิกรีเทิร์น
`File`	`ERROR(/File)` ที่แสดงไฟล์ APK จริงในโฮสต์ หรือ `null` หากไม่มีไฟล์

การขว้าง
`TargetSetupError`

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

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

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

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

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

parsePackageName

protected String parsePackageName (File testAppFile)

ดูชื่อแพ็กเกจจากแอปทดสอบ

พารามิเตอร์
`testAppFile`	`File`

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

การขว้าง
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

Helper to resolve some apk to their File and Package.

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

คิกรีเทิร์น

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

setTestInformation

protected void setTestInformation (TestInformation testInfo)

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

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

พยายามนำแพ็กเกจออกจากอุปกรณ์

พารามิเตอร์
`device`	`ITestDevice`
`packageName`	`String`

การขว้าง
`DeviceNotAvailableException`