Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável 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, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

BundletoolUtil

public class BundletoolUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.BundletoolUtil

Classe de utilitários que usa a linha de comando do bundletool para instalar os .apks no dispositivo. Link do documento do bundletool: https://developer.android.com/studio/command-line/bundletool. O bundletool.jar é baixado da ramificação do módulo descompactado junto com o arquivo do módulo.

Resumo

Construtores públicos
`BundletoolUtil(File bundletoolJar)`

Métodos públicos
`File`	`extractSplitsFromApks(File apks, String deviceSpecPath, ITestDevice device, IBuildInfo buildInfo)` Extrai o apk/apex dividido de .apks.
`String`	`generateDeviceSpecFile(ITestDevice device)` Gera um arquivo JSON para uma configuração de dispositivo conectado.
`void`	`installApks(File apks, ITestDevice device, List<String> extraArgs)` Instala o apk .apks que usa o bundletool.
`void`	`installApks(File apks, ITestDevice device)` Instala o apk .apks que usa o bundletool.
`void`	`installApksFromZip(File apksZip, ITestDevice device, List<String> extraArgs)` Instala os apks contidos no arquivo ZIP fornecido

Métodos protegidos
`String`	`getAdbPath()`
`File`	`getBundletoolFile()`
`IRunUtil`	`getRunUtil()`
`static long`	`parseCmdTimeout(List<String> args, long defaultValue)`

Construtores públicos

BundletoolUtil

public BundletoolUtil (File bundletoolJar)

Parâmetros
`bundletoolJar`	`File`

Métodos públicos

extractSplitsFromApks

public File extractSplitsFromApks (File apks, 
                String deviceSpecPath, 
                ITestDevice device, 
                IBuildInfo buildInfo)

Extrai o apk/apex dividido de .apks. Renomeia e armazena as divisões no diretório em que .apks está armazenado. Retorna o novo diretório em que as divisões estão armazenadas.

Parâmetros
`apks`	`File`: os apks que precisam ser extraídos
`deviceSpecPath`	`String`: o arquivo de especificação do dispositivo que o bundletool usa para extrair os apks
`device`	`ITestDevice`: o dispositivo conectado
`buildInfo`	`IBuildInfo`: informações do artefato de build

Retorna
`File`	um `File` que é o diretório em que o(s) apk(s)/apex extraído(s) estão

generateDeviceSpecFile

public String generateDeviceSpecFile (ITestDevice device)

Gera um arquivo JSON para uma configuração de dispositivo conectado.

Parâmetros
`device`	`ITestDevice`: o dispositivo conectado

Retorna
`String`	uma `String` que representa o caminho do arquivo de especificação do dispositivo.

Gera
`IOException`

installApks

public void installApks (File apks, 
                ITestDevice device, 
                List<String> extraArgs)

Instala o apk .apks que usa o bundletool.

Parâmetros
`apks`	`File`: os apks que precisam ser instalados
`device`	`ITestDevice`: o dispositivo conectado
`extraArgs`	`List`: para o comando bundletool.

Gera
`TargetSetupError`

installApks

public void installApks (File apks, 
                ITestDevice device)

Instala o apk .apks que usa o bundletool.

Parâmetros
`apks`	`File`: os apks que precisam ser instalados
`device`	`ITestDevice`: o dispositivo conectado

Gera
`TargetSetupError`

installApksFromZip

public void installApksFromZip (File apksZip, 
                ITestDevice device, 
                List<String> extraArgs)

Instala os apks contidos no arquivo ZIP fornecido

Parâmetros
`apksZip`	`File`: o arquivo ZIP a ser instalado
`device`	`ITestDevice`: o dispositivo conectado
`extraArgs`	`List`: argumentos extras a serem transmitidos para o comando de instalação do bundletool

Gera
`TargetSetupError`

Métodos protegidos

getAdbPath

protected String getAdbPath ()

Retorna
`String`

getBundletoolFile

protected File getBundletoolFile ()

Retorna
`File`

getRunUtil

protected IRunUtil getRunUtil ()

Retorna
`IRunUtil`

parseCmdTimeout

protected static long parseCmdTimeout (List<String> args, 
                long defaultValue)

Parâmetros
`args`	`List`
`defaultValue`	`long`

Retorna
`long`

Gera
`TargetSetupError`