自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 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`，用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的一个或多个应用安装到已分配的配套设备上。
SuiteApkInstaller	安装指定 APK 以进行 Suite 配置：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。

已知的间接子类

InstallApexModuleTargetPreparer、ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

一种从 IDeviceBuildInfo.getTestsDir() 文件夹向设备安装一个或多个应用的 ITargetPreparer。

如果测试 zip 不存在或不包含所需的 APK，此准备器将在备用目录中查找。搜索将按从最后一个指定的替代目录到第一个的顺序进行。

摘要

字段
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

公共构造函数
`TestAppInstallSetup()`

公共方法
`void`	`addInstallArg(String arg)` 添加要使用的一个 APK 安装实参。
`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，则返回 True。
`final boolean`	`isInstantMode()` 返回是否已启用即时模式安装。
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` 设置用于解析 APK 的 AAPT 版本。
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` 设置备用目录。
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` 设置备用目录行为。
`void`	`setCleanApk(boolean shouldClean)` 设置是否应在 tearDown 时清理已安装的 APK
`void`	`setForceQueryable(boolean forceQueryable)` 强制可查询的默认值为 true。
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` 设置是否在 TradeFed 准备器上启用增量设置。
`final void`	`setInstantMode(boolean mode)` 设置在安装 APK 时是否应使用 --instant。
`void`	`setShouldGrantPermission(boolean shouldGrant)` 如果提供了 userId，则可以为 APK 安装设置 grantPermission。
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` 此方法已弃用。临时向后兼容的回调。
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` 如果应为特定用户安装 APK，则设置要安装的用户 ID。
`void`	`tearDown(TestInformation testInfo, Throwable e)`

受保护的方法
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` 根据 build 信息中的测试制品信息解析实际的 APK 路径。
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` 尝试在设备上安装软件包或拆分软件包。
`String`	`parsePackageName(File testAppFile)` 从测试应用获取软件包名称。
	`resolveApkFiles(TestInformation testInfo, apkFiles)` 用于将某些 APK 解析为相应的文件和软件包的辅助程序。
`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 安装实参。

参数
`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，则返回 True。

返回
`boolean`

isInstantMode

public final boolean isInstantMode ()

返回是否已启用即时模式安装。

返回
`boolean`

reportDependencies

public  reportDependencies ()

返回

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

设置用于解析 APK 的 AAPT 版本。

参数
`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)

设置是否应在 tearDown 时清理已安装的 APK

参数
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

强制可查询的默认值为 true。如果待安装的 APK 不应可查询，请将其更新为 false。

参数
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

设置是否在 TradeFed preparer 上启用增量设置。

参数
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

设置在安装 APK 时是否应使用 --instant。如果设置了 force-install-mode，则不会产生任何影响。

参数
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

如果提供了 userId，则可以为 APK 安装设置 grantPermission。

参数
`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，则设置要安装的用户 ID。

参数
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

参数
`testInfo`	`TestInformation`
`e`	`Throwable`

抛出
`DeviceNotAvailableException`

受保护的方法

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

根据 build 信息中的测试制品信息解析实际的 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)

用于将某些 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`