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.

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 ser atribuído 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 um arquivo idsig extra à lista.
`TestDevice.MicrodroidBuilder`	`addTestDeviceOption(String optionName, String valueText)` Define um `TestDeviceOptions` para o TestDevice do microdroid.
`ITestDevice`	`build(TestDevice device)` Inicia um TestDevice do Micrdroid 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 da 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á descartado.
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` Cria um builder Microdroid para o apkPath fornecido e o arquivo de configuração de payload no APK.
`static TestDevice.MicrodroidBuilder`	`fromFile(File apkFile, String configPath)` Cria um builder Microdroid para o APK fornecido e o arquivo de configuração de payload no APK.
`TestDevice.MicrodroidBuilder`	`gki(String version)` Este método foi descontinuado. use `os(String)`.
`TestDevice.MicrodroidBuilder`	`hugePages(boolean hintHugePages)` Define se o kernel vai receber uma dica para hugepages 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 fornecida à VM.
`TestDevice.MicrodroidBuilder`	`name(String name)` Define o nome dessa VM.
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` Define o número de vCPUs na VM.
`TestDevice.MicrodroidBuilder`	`os(String os)` Usa a variante não padrão do SO Microdroid.
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` Define se a VM será protegida ou não.
`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 ser atribuído ao microdroid.

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

Retorna
`TestDevice.MicrodroidBuilder`	o builder de 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 NativeDevice.pushFile(File, String).

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

Retorna
`TestDevice.MicrodroidBuilder`	o builder de microdroid.

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

Adiciona um arquivo idsig extra à 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 da TestDeviceOption a ser definido.
`valueText`	`String`: o valor

Retorna
`TestDevice.MicrodroidBuilder`	o builder de microdroid.

build

public ITestDevice build (TestDevice device)

Inicia um TestDevice do Micrdroid 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 CPU para executar vCPUs. Por exemplo, "0,1-3, 5" para escolher as CPUs host 0, 1, 2, 3 e 5. Ou ela pode ser uma lista separada por dois-pontos de atribuições de vCPU para atribuições de CPU do host. Por exemplo, "0=0:1=1:2=2" para mapear a vCPU 0 para a CPU 0 do host e assim por diante.

Suporte apenas no Android T.

Parâmetros
`affinity`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

Define a configuração da 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á descartado.

Valores aceitos: null e "path".

Parâmetros
`dumpDt`	`String`

Retorna
`TestDevice.MicrodroidBuilder`

fromDevicePath

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

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

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

Retorna
`TestDevice.MicrodroidBuilder`

fromFile

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

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

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

Retorna
`TestDevice.MicrodroidBuilder`

gki

public TestDevice.MicrodroidBuilder gki (String version)

Este 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 vai receber uma dica para hugepages transparentes.

Parâmetros
`hintHugePages`	`boolean`

Retorna
`TestDevice.MicrodroidBuilder`	o builder de microdroid.

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

Define o caminho instance_id.

Parâmetros
`instanceIdPath`	`String`: : caminho para a 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 fornecida à VM. Se o valor 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 dessa VM.

Parâmetros
`name`	`String`

Retorna
`TestDevice.MicrodroidBuilder`	o builder de microdroid.

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

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

Suporte apenas no Android T.

Parâmetros
`num`	`int`

Retorna
`TestDevice.MicrodroidBuilder`

os

public TestDevice.MicrodroidBuilder os (String os)

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

Parâmetros
`os`	`String`: a versão do Microdroid OS 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`

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

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

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

Retorna
`TestDevice.MicrodroidBuilder`