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.

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

TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

java.lang.Object
↳	com.android.tradefed.device.TestDevice.MicrodroidBuilder

Um builder usado para criar um Microdroid TestDevice.

Resumo

Métodos públicos
`TestDevice.MicrodroidBuilder`	`addAssignableDevice(String sysfsNode)` Adiciona um dispositivo para atribuir ao microdroid.
`TestDevice.MicrodroidBuilder`	`addBootFile(File localFile, String remoteFileName)` Adiciona um arquivo para inicialização a ser enviado para `ERROR(/#TEST_ROOT)`.
`TestDevice.MicrodroidBuilder`	`addExtraIdsigPath(String extraIdsigPath)` Adiciona outro arquivo idsig à lista.
`TestDevice.MicrodroidBuilder`	`addTestDeviceOption(String optionName, String valueText)` Define um `TestDeviceOptions` para o TestDevice do microdroid.
`ITestDevice`	`build(TestDevice device)` Inicia um Micrdroid TestDevice no TestDevice especificado.
`TestDevice.MicrodroidBuilder`	`cpuAffinity(String affinity)` Define em quais CPUs host as vCPUs podem ser executadas.
`TestDevice.MicrodroidBuilder`	`cpuTopology(String cpuTopology)` Define a configuração de topologia da CPU.
`TestDevice.MicrodroidBuilder`	`debugLevel(String debugLevel)` Define o nível de depuração.
`TestDevice.MicrodroidBuilder`	`dumpDt(String dumpDt)` Define o caminho em que o blob da árvore de dispositivos será despejado.
`TestDevice.MicrodroidBuilder`	`enableEarlycon(boolean enableEarlycon)` Ativa os registros earlycon para esta VM.
`TestDevice.MicrodroidBuilder`	`forceStartAdbd(boolean forceStartAdbd)` Chama à força `vm start-adbd` entre `vm run` e `adb forward` OBSERVAÇÃO: nos níveis de API mais antigos (antes do SDK 36), essa função não faz nada.
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` Cria um builder de Microdroid para o apkPath e o arquivo de configuração de payload especificados no APK.
`static TestDevice.MicrodroidBuilder`	`fromDevicePathWithPayloadBinaryName(String apkPath, String payloadBinaryName)` Cria um builder de Microdroid para o apkPath e o nome binário do payload especificados no APK.
`static TestDevice.MicrodroidBuilder`	`fromFile(File apkFile, String configPath)` Cria um builder do Microdroid para o APK e o arquivo de configuração de payload especificados no APK.
`TestDevice.MicrodroidBuilder`	`gki(String version)` Esse método foi descontinuado. usar `os(String)`.
`TestDevice.MicrodroidBuilder`	`hugePages(boolean hintHugePages)` Define se o kernel deve ser avisado sobre páginas grandes transparentes.
`TestDevice.MicrodroidBuilder`	`instanceIdFile(String instanceIdPath)` Define o caminho "instance_id".
`TestDevice.MicrodroidBuilder`	`instanceImgFile(String instanceImgPath)` Define o caminho do arquivo instance.img.
`TestDevice.MicrodroidBuilder`	`memoryMib(int memoryMib)` Define a quantidade de RAM a ser atribuída à VM.
`TestDevice.MicrodroidBuilder`	`name(String name)` Define o nome desta VM.
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` Define o número de vCPUs na VM.
`TestDevice.MicrodroidBuilder`	`os(String os)` Usa uma variante não padrão do SO Microdroid.
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` Define se a VM será protegida ou não.
`TestDevice.MicrodroidBuilder`	`ramdump(boolean useRamdump)` Define se o kernel de falha será desativado para ramdumps.
`TestDevice.MicrodroidBuilder`	`setAdbConnectTimeoutMs(long timeoutMs)` Define o tempo limite para a conexão adb com o microdroid TestDevice em milissegundos.

Métodos públicos

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

Adiciona um dispositivo para atribuir ao microdroid.

Parâmetros
`sysfsNode`	`String`: o caminho para o nó sysfs a ser atribuído

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

addBootFile

public TestDevice.MicrodroidBuilder addBootFile (File localFile, 
                String remoteFileName)

Adiciona um arquivo para inicialização a ser enviado para ERROR(/#TEST_ROOT).

Use esse método se um arquivo for necessário para inicializar o microdroid. Caso contrário, use TestDevice.pushFile.

Parâmetros
`localFile`	`File`: o arquivo local no host.
`remoteFileName`	`String`: o nome do arquivo remoto no dispositivo

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

Adiciona outro arquivo idsig à lista.

Parâmetros
`extraIdsigPath`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

addTestDeviceOption

public TestDevice.MicrodroidBuilder addTestDeviceOption (String optionName, 
                String valueText)

Define um TestDeviceOptions para o TestDevice do microdroid.

Parâmetros
`optionName`	`String`: o nome do TestDeviceOption a ser definido.
`valueText`	`String`: o valor

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

build

public ITestDevice build (TestDevice device)

Inicia um Micrdroid TestDevice no TestDevice especificado.

Parâmetros
`device`	`TestDevice`

Retorna
`ITestDevice`

Gera
`DeviceNotAvailableException`

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

Define em quais CPUs host as vCPUs podem ser executadas. O formato é uma lista separada por vírgulas de CPUs ou intervalos de CPUs para executar vCPUs. Por exemplo, "0,1-3, 5" para escolher as CPUs do host 0, 1, 2, 3 e 5. Ou pode ser uma lista separada por dois-pontos de atribuições de vCPU a CPU do host. Por exemplo, "0=0:1=1:2=2" para mapear a vCPU 0 para a CPU do host 0 e assim por diante.

Disponível apenas no Android T.

Parâmetros
`affinity`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

Define a configuração de topologia da CPU. Valores aceitos: "one_cpu" e "match_host".

Parâmetros
`cpuTopology`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

Define o nível de depuração.

Valores aceitos: "none" e "full". O Android T também oferece suporte a "app_only".

Parâmetros
`debugLevel`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

Define o caminho em que o blob da árvore de dispositivos será despejado.

Valores aceitos: null e "path".

Parâmetros
`dumpDt`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

Ativa os registros earlycon para esta VM.

OBSERVAÇÃO: nos níveis de API mais antigos (antes do SDK 36), essa função não faz nada.

Parâmetros
`enableEarlycon`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

Chama à força `vm start-adbd` entre `vm run` e `adb forward`

OBSERVAÇÃO: nos níveis de API mais antigos (antes do SDK 36), essa função não faz nada.

Parâmetros
`forceStartAdbd`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

fromDevicePath

public static TestDevice.MicrodroidBuilder fromDevicePath (String apkPath, 
                String configPath)

Cria um builder de Microdroid para o apkPath e o arquivo de configuração de payload especificados no APK.

Parâmetros
`apkPath`	`String`
`configPath`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

fromDevicePathWithPayloadBinaryName

public static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName (String apkPath, 
                String payloadBinaryName)

Cria um builder de Microdroid para o apkPath e o nome binário do payload especificados no APK.

Parâmetros
`apkPath`	`String`
`payloadBinaryName`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

fromFile

public static TestDevice.MicrodroidBuilder fromFile (File apkFile, 
                String configPath)

Cria um builder do Microdroid para o APK e o arquivo de configuração de payload especificados no APK.

Parâmetros
`apkFile`	`File`
`configPath`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

gki

public TestDevice.MicrodroidBuilder gki (String version)

Esse método foi descontinuado.
use os(String).

Usa o kernel GKI em vez do kernel microdroid.

Parâmetros
`version`	`String`: a versão do GKI a ser usada

Retorna
`TestDevice.MicrodroidBuilder`

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

Define se o kernel deve ser avisado sobre páginas grandes transparentes.

Parâmetros
`hintHugePages`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

Define o caminho "instance_id".

Parâmetros
`instanceIdPath`	`String`: : caminho para o instanceId

Retorna
`TestDevice.MicrodroidBuilder`

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

Define o caminho do arquivo instance.img.

Parâmetros
`instanceImgPath`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

Define a quantidade de RAM a ser atribuída à VM. Se for zero ou negativo, o padrão será usado.

Parâmetros
`memoryMib`	`int`

Retorna
`TestDevice.MicrodroidBuilder`

nome

public TestDevice.MicrodroidBuilder name (String name)

Define o nome desta VM.

Parâmetros
`name`	`String`

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

Define o número de vCPUs na VM. O padrão é 1.

Disponível apenas no Android T.

Parâmetros
`num`	`int`

Retorna
`TestDevice.MicrodroidBuilder`

os

public TestDevice.MicrodroidBuilder os (String os)

Usa uma variante não padrão do SO Microdroid.

Parâmetros
`os`	`String`: a versão do SO Microdroid a ser usada

Retorna
`TestDevice.MicrodroidBuilder`

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

Define se a VM será protegida ou não.

Parâmetros
`isProtectedVm`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

Define se o kernel de falha será desativado para ramdumps.

Parâmetros
`useRamdump`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`	o builder do microdroid.

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

Define o tempo limite para a conexão adb com o microdroid TestDevice em milissegundos.

Precisa ser positivo para evitar travamentos de teste.

Parâmetros
`timeoutMs`	`long`: o tempo limite em milissegundos

Retorna
`TestDevice.MicrodroidBuilder`