ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

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 ที่ระบุสำหรับการกำหนดค่าชุดทดสอบจากตัวแปร $ANDROID_TARGET_OUT_TESTCASES หรือ ROOT_DIR ในข้อมูลบิลด์

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

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

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

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

สรุป

ช่อง
`protected IncrementalInstallSession`	`incrementalInstallSession`
`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()` แสดงค่า "จริง" หากระบบจะล้างข้อมูล 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)` ค่าเริ่มต้นของ "บังคับให้ค้นหาได้" คือ "จริง"
`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)` เราเลิกใช้งานเมธอดนี้แล้ว Callback แบบย้อนหลังชั่วคราว
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` หากควรติดตั้ง APK สำหรับผู้ใช้บางราย ให้ตั้งค่ารหัสของผู้ใช้ที่จะติดตั้ง
`void`	`tearDown(TestInformation testInfo, Throwable e)`

วิธีการที่มีการป้องกัน
`IncrementalInstallSession.Builder`	`getIncrementalInstallSessionBuilder()` เริ่มต้นสร้างโปรแกรมสร้างเซสชันสําหรับการติดตั้งแอปทดสอบทีละรายการ
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` แก้ไขเส้นทาง apk จริงตามข้อมูลอาร์ติแฟกต์การทดสอบภายในข้อมูลบิลด์
`void`	`installPackageIncrementally(IncrementalInstallSession.Builder builder)` เริ่มเซสชันการติดตั้งแบบเพิ่มทีละรายการสําหรับแอปทดสอบ
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` พยายามติดตั้งแพ็กเกจหรือแยกแพ็กเกจในอุปกรณ์
`String`	`parsePackageName(File testAppFile)` รับชื่อแพ็กเกจจากแอปทดสอบ
	`resolveApkFiles(TestInformation testInfo, apkFiles)` ตัวช่วยในการแก้ไข apk บางรายการเป็นไฟล์และแพ็กเกจ
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` พยายามนำแพ็กเกจออกจากอุปกรณ์

ช่อง

incrementalInstallSession

protected IncrementalInstallSession incrementalInstallSession

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 ()

แสดงค่า "จริง" หากระบบจะล้างข้อมูล 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)

ค่าเริ่มต้นของ "บังคับให้ค้นหาได้" คือ "จริง" อัปเดตเป็นเท็จหาก 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`

วิธีการที่มีการป้องกัน

getIncrementalInstallSessionBuilder

protected IncrementalInstallSession.Builder getIncrementalInstallSessionBuilder ()

เริ่มต้นสร้างโปรแกรมสร้างเซสชันสําหรับการติดตั้งแอปทดสอบทีละรายการ

คิกรีเทิร์น
`IncrementalInstallSession.Builder`

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

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

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

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

การโยน
`TargetSetupError`

installPackageIncrementally

protected void installPackageIncrementally (IncrementalInstallSession.Builder builder)

เริ่มเซสชันการติดตั้งแบบเพิ่มทีละรายการสําหรับแอปทดสอบ

พารามิเตอร์
`builder`	`IncrementalInstallSession.Builder`: ออบเจ็กต์ Builder สําหรับเซสชันการติดตั้งที่เพิ่มขึ้น

การโยน
	com.android.tradefed.targetprep.TargetSetupError
`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)

ตัวช่วยในการแก้ไข apk บางรายการเป็นไฟล์และแพ็กเกจ

พารามิเตอร์
`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`