此页面由 Cloud Translation API 翻译。

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies

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

已知的直接子类

CompanionTestAppInstallSetup、SuiteApkInstaller

CompanionTestAppInstallSetup	用于将 `IDeviceBuildInfo#getTestsDir()` 文件夹中的一个或多个应用安装到分配的配套设备上的 `ITargetPreparer`。
SuiteApkInstaller	为套件配置安装指定的 APK：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。

已知的间接子类

InstallApexModuleTargetPreparer、ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个应用安装到设备上的 ITargetPreparer。

如果测试 ZIP 文件不存在或不包含所需的 APK，此准备程序将在其他目录中查找。搜索将按从最后一个指定的备选目录到第一个备选目录的顺序进行。

摘要

字段
`protected IncrementalInstallSession`	`incrementalInstallSession`
`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)` 设置是否应在拆解时清除已安装的 APK
`void`	`setForceQueryable(boolean forceQueryable)` 强制可查询的默认值为 true。
`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)`

受保护的方法
`IncrementalInstallSession.Builder`	`getIncrementalInstallSessionBuilder()` 初始化会话构建器以增量安装测试应用。
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` 根据 build 信息中的测试工件信息解析实际的 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)` 尝试从设备中移除软件包。

字段

增量安装会话

protected IncrementalInstallSession incrementalInstallSession

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

m 增量安装

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`

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`

设置

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`

受保护的方法

getIncrementalInstallSessionBuilder

protected IncrementalInstallSession.Builder getIncrementalInstallSessionBuilder ()

初始化会话构建器以增量安装测试应用。

返回
`IncrementalInstallSession.Builder`

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

根据 build 信息中的测试工件信息解析实际的 APK 路径。

参数
`testInfo`	`TestInformation`：调用的 `TestInformation`。
`apkFileName`	`String`：要安装的 APK 的文件名

返回
`File`	表示主机上的物理 APK 文件的 `ERROR(/File)`，如果文件不存在，则为 `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`