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_OPTION`
`protected static final String`	`APEX_SUFFIX`
`protected static final String`	`APK_SUFFIX`
`protected static final String`	`APK_ZIP_OPTION`
`protected static final String`	`CHILD_SESSION_CREATION_CMD`
`protected static final String`	`PARENT_SESSION_CREATION_CMD`
`public static final String`	`ROLLBACK_STATE_COMMITTED`
`public static final String`	`ROLLBACK_STATE_UNKNOWN`
`protected static final String`	`SPLIT_APKS_SUFFIX`
`protected File`	`mTrainFolderPath`

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()`
`void`	`addStagedReadyTimeoutForAdb( cmd)`
`void`	`addTimeoutMillisForBundletool( extraArgs)`
`void`	`checkApexActivation(ITestDevice device)` Verifique se todos os picos estão ativados.
	`collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo)` Coleta informações do Apex dos módulos do Apex para verificação de ativação.
	`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)` 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.
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` Recupera o ApexInfo que contém packageName e versionCode do arquivo apex fornecido.

Campos

APEX_OPTION

protected static final String APEX_OPTION

APEX_SUFFIX

protected static final String APEX_SUFFIX

APK_SUFFIX

protected static final String APK_SUFFIX

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

mTrainFolderPath

protected File mTrainFolderPath

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`
`DeviceRuntimeException`

Métodos protegidos

addApksToTestFiles

protected void addApksToTestFiles ()

addStagedReadyTimeoutForAdb

protected void addStagedReadyTimeoutForAdb ( cmd)

Parâmetros
`cmd`

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool ( extraArgs)

Parâmetros
`extraArgs`

checkApexActivation

protected void checkApexActivation (ITestDevice device)

Verifique se todos os picos estão ativados.

Parâmetros
`device`	`ITestDevice`: em teste.

Gera
`TargetSetupError`	se a ativação tiver falhado.
`DeviceNotAvailableException`

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`

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)

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.

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`

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.