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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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.