A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

Subclasses diretas conhecidas

CompanionTestAppInstallSetup, SuiteApkInstaller

CompanionTestAppInstallSetup	Um `ITargetPreparer` que instala um ou mais apps de uma pasta `IDeviceBuildInfo.getTestsDir()` em um dispositivo complementar alocado.
SuiteApkInstaller	Instala os APKs especificados para configuração da Suite: da variável $ANDROID_TARGET_OUT_TESTCASES ou do ROOT_DIR nas informações de build.

Subclasses indiretas conhecidas

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

Um ITargetPreparer que instala um ou mais apps de uma pasta IDeviceBuildInfo.getTestsDir() no dispositivo.

Esse preparador vai procurar em diretórios alternativos se o zip de testes não existir ou não tiver o APK necessário. A pesquisa será feita em ordem, do último diretório alternativo especificado até o primeiro.

Resumo

Campos
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

Construtores públicos
`TestAppInstallSetup()`

Métodos públicos
`void`	`addInstallArg(String arg)` Adiciona um argumento de instalação de APK a ser usado.
`void`	`addSplitApkFileNames(String fileNames)` Adiciona um conjunto de nomes de arquivos divididos por "," em uma string para serem instalados como APKs divididos.
`void`	`addTestFile(File file)` Adiciona um arquivo ou diretório à lista de APKs a serem instalados.
`void`	`addTestFileName(String fileName)` Adiciona um nome de arquivo à lista de APKs a serem instalados.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` Retorna o dispositivo a que o preparador deve ser aplicado.
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` Retorna uma cópia da lista de nomes de APK de teste especificados.
`boolean`	`isCleanUpEnabled()` Retorna "True" se os APKs forem limpos durante a desmontagem.
`final boolean`	`isInstantMode()` Retorna se a instalação do modo instantâneo foi ativada ou não.
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` Define a versão do AAPT para análise de APK.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` Defina um diretório alternativo.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` Defina comportamentos alternativos de diretório.
`void`	`setCleanApk(boolean shouldClean)` Define se o APK instalado deve ser limpo no tearDown.
`void`	`setForceQueryable(boolean forceQueryable)` O valor padrão de "force queryable" é "true".
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` Defina se a configuração incremental será ativada nos preparadores do TradeFed.
`final void`	`setInstantMode(boolean mode)` Define se --instant deve ser usado ao instalar o APK.
`void`	`setShouldGrantPermission(boolean shouldGrant)` Se um userId for fornecido, grantPermission poderá ser definido para a instalação do APK.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Esse método foi descontinuado. Callback temporário compatível com versões anteriores.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` Se o APK precisar ser instalado para um usuário específico, defina o ID do usuário para a instalação.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Métodos protegidos
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` Resolva o caminho real do APK com base nas informações do artefato de teste dentro das informações de build.
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` Tente instalar um pacote ou pacote dividido no dispositivo.
`String`	`parsePackageName(File testAppFile)` Receba o nome do pacote do app de teste.
	`resolveApkFiles(TestInformation testInfo, apkFiles)` Auxiliar para resolver alguns APKs no arquivo e pacote deles.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` Tente remover o pacote do dispositivo.

Campos

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

Construtores públicos

TestAppInstallSetup

public TestAppInstallSetup ()

Métodos públicos

addInstallArg

public void addInstallArg (String arg)

Adiciona um argumento de instalação de APK a ser usado.

Parâmetros
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

Adiciona um conjunto de nomes de arquivos divididos por "," em uma string para serem instalados como APKs divididos.

Parâmetros
`fileNames`	`String`: uma string de nomes de arquivos divididos por ","

addTestFile

public void addTestFile (File file)

Adiciona um arquivo ou diretório à lista de APKs a serem instalados.

Parâmetros
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

Adiciona um nome de arquivo à lista de APKs a serem instalados.

Parâmetros
`fileName`	`String`

getAbi

public IAbi getAbi ()

Retorna
`IAbi`

getDevice

public ITestDevice getDevice ()

Retorna o dispositivo a que o preparador deve ser aplicado.

Retorna
`ITestDevice`

Gera
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

Retorna
`TestInformation`

getTestsFileName

public  getTestsFileName ()

Retorna uma cópia da lista de nomes de APK de teste especificados.

Retorna

isCleanUpEnabled

public boolean isCleanUpEnabled ()

Retorna "True" se os APKs forem limpos durante a desmontagem.

Retorna
`boolean`

isInstantMode

public final boolean isInstantMode ()

Retorna se a instalação do modo instantâneo foi ativada ou não.

Retorna
`boolean`

reportDependencies

public  reportDependencies ()

Retorna

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

Define a versão do AAPT para análise de APK.

Parâmetros
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

Parâmetros
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

Defina um diretório alternativo.

Parâmetros
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

Defina comportamentos alternativos de diretório.

Parâmetros
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

Define se o APK instalado deve ser limpo no tearDown.

Parâmetros
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

O valor padrão de "force queryable" é "true". Atualize para "false" se o APK a ser instalado não puder ser consultado.

Parâmetros
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

Defina se a configuração incremental será ativada nos preparadores do TradeFed.

Parâmetros
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

Define se --instant deve ser usado ao instalar o APK. Não terá efeito se force-install-mode estiver definido.

Parâmetros
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

Se um userId for fornecido, grantPermission poderá ser definido para a instalação do APK.

Parâmetros
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Esse método foi descontinuado.
Callback temporário compatível com versões anteriores.

Parâmetros
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

Gera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

Gera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

Se o APK precisar ser instalado para um usuário específico, defina o ID do usuário para a instalação.

Parâmetros
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parâmetros
`testInfo`	`TestInformation`
`e`	`Throwable`

Gera
`DeviceNotAvailableException`

Métodos protegidos

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

Resolva o caminho real do APK com base nas informações do artefato de teste dentro das informações de build.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation` da invocação.
`apkFileName`	`String`: nome do arquivo APK a ser instalado

Retorna
`File`	um `ERROR(/File)` que representa o arquivo APK físico no host ou `null` se o arquivo não existir.

Gera
`TargetSetupError`

instalador

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

Tente instalar um pacote ou pacote dividido no dispositivo.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation` da invocação
`appFilesAndPackages`	: os APKs e o pacote deles a serem instalados.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

Receba o nome do pacote do app de teste.

Parâmetros
`testAppFile`	`File`

Retorna
`String`

Gera
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

Auxiliar para resolver alguns APKs no arquivo e pacote deles.

Parâmetros
`testInfo`	`TestInformation`
`apkFiles`

Retorna

Gera
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

Tente remover o pacote do dispositivo.

Parâmetros
`device`	`ITestDevice`
`packageName`	`String`

Gera
`DeviceNotAvailableException`