A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

InstallApexModuleTargetPreparer

public class InstallApexModuleTargetPreparer
extends SuiteApkInstaller

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup
		↳	com.android.tradefed.targetprep.suite.SuiteApkInstaller
			↳	com.android.tradefed.targetprep.InstallApexModuleTargetPreparer

Subclasses diretas conhecidas

ModuleOemTargetPreparer

Resumo

Campos
`protected static final String`	`APEX_SUFFIX`
`protected static final String`	`APK_SUFFIX`
`protected static final String`	`SPLIT_APKS_SUFFIX`

Construtores públicos
`InstallApexModuleTargetPreparer()`

Métodos públicos
	`getModulesToInstall(TestInformation testInfo)` Recebe os módulos que precisam ser instalados no trem com base nos módulos pré-carregados no dispositivo.
`void`	`setIgnoreIfNotPreloaded(boolean skip)`
`void`	`setSkipApexTearDown(boolean skip)`
`void`	`setUp(TestInformation testInfo)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Métodos protegidos
`void`	`addApksToTestFiles()`
	`collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo)` Coleta informações do Apex dos módulos do Apex para verificação de ativação.
`boolean`	`containsPersistentApk( testAppFileNames, TestInformation testInfo)` Verifica se os arquivos de entrada contêm algum apk persistente.
	`getApkInstalled()`
`String`	`getBundletoolFileName()`
`BundletoolUtil`	`getBundletoolUtil()`
`String`	`getModuleKeywordFromApexPackageName(String packageName)` Recebe a palavra-chave (por exemplo, "tzdata" para com.android.tzdata.apex) do nome do pacote apex.
	`getModulesFailToActivate( activatedApexes)` Receber módulos que não foram ativados.
	`getSplitsForApks(TestInformation testInfo, File moduleFile)` Extrai e retorna divisões para os APKs especificados.
`void`	`initBundletoolUtil(TestInformation testInfo)` Inicializa o utilitário bundletool para esta classe.
`void`	`installTrain(TestInformation testInfo, moduleFilenames, String[] extraArgs)` Tenta instalar um trem principal que contém o apex no dispositivo.
`void`	`installUsingBundleTool(TestInformation testInfo, testAppFileNames)` Tenta instalar módulos principais usando o bundletool.
`void`	`installer(TestInformation testInfo, testAppFileNames)` Tente instalar um pacote ou pacote dividido no dispositivo.
`boolean`	`isPersistentApk(File filename, TestInformation testInfo)` Verifica se um APK é persistente.
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` Recupera o ApexInfo que contém packageName e versionCode do arquivo apex fornecido.

Campos

APEX_SUFFIX

protected static final String APEX_SUFFIX

APK_SUFFIX

protected static final String APK_SUFFIX

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

Construtores públicos

InstallApexModuleTargetPreparer

public InstallApexModuleTargetPreparer ()

Métodos públicos

getModulesToInstall

public  getModulesToInstall (TestInformation testInfo)

Recebe os módulos que precisam ser instalados no trem com base nos módulos pré-carregados no dispositivo. Os módulos que não forem pré-carregados não serão instalados.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation`

Retorna
	Lista dos módulos que precisam ser instalados no dispositivo.

Gera
`DeviceNotAvailableException`	quando o dispositivo não está disponível.
`TargetSetupError`	quando módulos obrigatórios não são instalados ou não podem ser instalados.

setIgnoreIfNotPreloaded

public void setIgnoreIfNotPreloaded (boolean skip)

Parâmetros
`skip`	`boolean`

setSkipApexTearDown

public void setSkipApexTearDown (boolean skip)

Parâmetros
`skip`	`boolean`

setUp

public void setUp (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

Gera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

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

Gera
`DeviceNotAvailableException`

Métodos protegidos

addApksToTestFiles

protected void addApksToTestFiles ()

collectApexInfoFromApexModules

protected  collectApexInfoFromApexModules ( testAppFileNames, 
                TestInformation testInfo)

Coleta informações do Apex dos módulos do Apex para verificação de ativação.

Parâmetros
`testAppFileNames`	: a lista dos nomes de arquivo dos módulos a serem instalados
`testInfo`	`TestInformation`: o `TestInformation`

Retorna
	uma lista com o apexinfo dos módulos apex nas listas de arquivos de entrada

Gera
`TargetSetupError`

containsPersistentApk

protected boolean containsPersistentApk ( testAppFileNames, 
                TestInformation testInfo)

Verifica se os arquivos de entrada contêm algum apk persistente.

Parâmetros
`testAppFileNames`	: a lista dos nomes de arquivo dos módulos a serem instalados
`testInfo`	`TestInformation`: o `TestInformation`

Retorna
`boolean`	`true` se os arquivos de entrada contêm um módulo apk persistente.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

getApkInstalled

protected  getApkInstalled ()

Retorna

getBundletoolFileName

protected String getBundletoolFileName ()

Retorna
`String`

getBundletoolUtil

protected BundletoolUtil getBundletoolUtil ()

Retorna
`BundletoolUtil`

getModuleKeywordFromApexPackageName

protected String getModuleKeywordFromApexPackageName (String packageName)

Recebe a palavra-chave (por exemplo, "tzdata" para com.android.tzdata.apex) do nome do pacote apex.

Parâmetros
`packageName`	`String`: o nome do pacote do arquivo Apex.

Retorna
`String`	uma string A palavra-chave do nome do pacote principal.

getModulesFailToActivate

protected  getModulesFailToActivate ( activatedApexes)

Receber módulos que não foram ativados.

Parâmetros
`activatedApexes`	: o conjunto de vértices ativos no dispositivo

Retorna
	uma lista com o apexinfo dos módulos Apex de entrada que não foram ativados.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

getSplitsForApks

protected  getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

Extrai e retorna divisões para os APKs especificados.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation`
`moduleFile`	`File`: o arquivo do módulo para extrair as divisões.

Retorna
	um File[] que contém as divisões.

Gera
`TargetSetupError`	se o bundletool não for encontrado ou se o arquivo de especificação do dispositivo não for gerado.

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

Inicializa o utilitário bundletool para esta classe.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation` da invocação.

Gera
`TargetSetupError`	se o bundletool não for encontrado.

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames, 
                String[] extraArgs)

Tenta instalar um trem principal que contém o apex no dispositivo.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation`
`moduleFilenames`	: lista de strings. A lista de nomes de arquivos dos módulos principais a serem instalados.
`extraArgs`	`String`

Gera
`DeviceNotAvailableException`
`TargetSetupError`

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                 testAppFileNames)

Tenta instalar módulos principais usando o bundletool.

Parâmetros
`testInfo`	`TestInformation`: o `TestInformation`
`testAppFileNames`	: os nomes de arquivo dos módulos pré-carregados a serem instalados.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

instalador

protected void installer (TestInformation testInfo, 
                 testAppFileNames)

Tente instalar um pacote ou pacote dividido no dispositivo.

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

Gera
`DeviceNotAvailableException`
`TargetSetupError`

isPersistentApk

protected boolean isPersistentApk (File filename, 
                TestInformation testInfo)

Verifica se um APK é persistente.

Parâmetros
`filename`	`File`: o arquivo do módulo apk a ser verificado
`testInfo`	`TestInformation`: o `TestInformation`

Retorna
`boolean`	`true`, se for um módulo de APK persistente.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

retrieveApexInfo

protected ITestDevice.ApexInfo retrieveApexInfo (File testApexFile, 
                DeviceDescriptor deviceDescriptor)

Recupera o ApexInfo que contém packageName e versionCode do arquivo apex fornecido.

Parâmetros
`testApexFile`	`File`: o arquivo Apex de onde extraímos as informações.
`deviceDescriptor`	`DeviceDescriptor`

Retorna
`ITestDevice.ApexInfo`	um `ApexInfo` contendo o packageName e o versionCode do arquivo fornecido

Gera
`TargetSetupError`	se o analisador aapt não conseguir analisar o arquivo.