此页面由 Cloud Translation API 翻译。

TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

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

用于创建 Microdroid TestDevice 的构建器。

摘要

公共方法
`TestDevice.MicrodroidBuilder`	`addAssignableDevice(String sysfsNode)` 添加要分配给 Microdroid 的设备。
`TestDevice.MicrodroidBuilder`	`addBootFile(File localFile, String remoteFileName)` 添加要推送到 `ERROR(/#TEST_ROOT)` 的启动文件。
`TestDevice.MicrodroidBuilder`	`addExtraIdsigPath(String extraIdsigPath)` 将额外的 idsig 文件添加到列表中。
`TestDevice.MicrodroidBuilder`	`addTestDeviceOption(String optionName, String valueText)` 为 Microdroid TestDevice 设置 `TestDeviceOptions`。
`ITestDevice`	`build(TestDevice device)` 在给定 TestDevice 上启动 Micrdroid TestDevice。
`TestDevice.MicrodroidBuilder`	`cpuAffinity(String affinity)` 设置 vCPU 可以在哪些主机 CPU 上运行。
`TestDevice.MicrodroidBuilder`	`cpuTopology(String cpuTopology)` 设置 CPU 拓扑配置。
`TestDevice.MicrodroidBuilder`	`debugLevel(String debugLevel)` 设置调试级别。
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` 为给定的 apkPath 和 APK 中的载荷配置文件创建 Microdroid 构建器。
`static TestDevice.MicrodroidBuilder`	`fromFile(File apkFile, String configPath)` 为给定的 APK 和 APK 中的载荷配置文件创建 Microdroid 构建器。
`TestDevice.MicrodroidBuilder`	`gki(String version)` 使用 GKI 内核而不是 Microdroid 内核
`TestDevice.MicrodroidBuilder`	`hugePages(boolean hintHugePages)` 设置是否提示内核启用透明大页。
`TestDevice.MicrodroidBuilder`	`instanceIdFile(String instanceIdPath)` 设置 instance_id 路径。
`TestDevice.MicrodroidBuilder`	`instanceImgFile(String instanceImgPath)` 设置 instance.img 文件路径。
`TestDevice.MicrodroidBuilder`	`memoryMib(int memoryMib)` 设置要为虚拟机提供的 RAM 容量。
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` 设置虚拟机中的 vCPU 数量。
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` 设置虚拟机是否受保护。
`TestDevice.MicrodroidBuilder`	`setAdbConnectTimeoutMs(long timeoutMs)` 设置 adb 连接到 Microdroid TestDevice 的超时时间（以毫秒为单位）。

公共方法

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

添加要分配给 Microdroid 的设备。

参数
`sysfsNode`	`String`：要分配的 sysfs 节点的路径

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器

addBootFile

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

添加要推送到 ERROR(/#TEST_ROOT) 的启动文件。

如果启动 Microdroid 需要文件，请使用此方法。否则，请使用 NativeDevice.pushFile(File, String)。

参数
`localFile`	`File`：主机上的本地文件
`remoteFileName`	`String`：设备上的远程文件名

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

将额外的 idsig 文件添加到列表中。

参数
`extraIdsigPath`	`String`

返回
`TestDevice.MicrodroidBuilder`

addTestDeviceOption

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

为 Microdroid TestDevice 设置 TestDeviceOptions。

参数
`optionName`	`String`：要设置的 TestDeviceOption 的名称
`valueText`	`String`：值

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器

build

public ITestDevice build (TestDevice device)

在指定的 TestDevice 上启动 Micrdroid TestDevice。

参数
`device`	`TestDevice`

返回
`ITestDevice`

抛出
`DeviceNotAvailableException`

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

设置 vCPU 可以在哪些主机 CPU 上运行。格式为运行 vCPU 的 CPU 或 CPU 范围列表（以英文逗号分隔）。例如，“0,1-3,5”表示选择主机 CPU 0、1、2、3 和 5。或者，它可以是一个以英文冒号分隔的列表，其中包含从 vCPU 到主机 CPU 的分配。例如，“0=0:1=1:2=2”表示将 vCPU 0 映射到主机 CPU 0，依此类推。

仅在 Android T 中受支持。

参数
`affinity`	`String`

返回
`TestDevice.MicrodroidBuilder`

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

设置 CPU 拓扑配置。支持的值：“one_cpu”和“match_host”。

参数
`cpuTopology`	`String`

返回
`TestDevice.MicrodroidBuilder`

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

设置调试级别。

支持的值：“none”和“full”。Android T 还支持“app_only”。

参数
`debugLevel`	`String`

返回
`TestDevice.MicrodroidBuilder`

fromDevicePath

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

为给定的 apkPath 和 APK 中的载荷配置文件创建 Microdroid 构建器。

参数
`apkPath`	`String`
`configPath`	`String`

返回
`TestDevice.MicrodroidBuilder`

fromFile

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

为给定的 APK 和 APK 中的载荷配置文件创建 Microdroid 构建器。

参数
`apkFile`	`File`
`configPath`	`String`

返回
`TestDevice.MicrodroidBuilder`

Gki

public TestDevice.MicrodroidBuilder gki (String version)

使用 GKI 内核，而不是 Microdroid 内核

参数
`version`	`String`：要使用的 GKI 版本

返回
`TestDevice.MicrodroidBuilder`

大页

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

设置是否提示内核显示透明大页。

参数
`hintHugePages`	`boolean`

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器

实例 ID 文件

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

设置 instance_id 路径。

参数
`instanceIdPath`	`String`：instanceId 的路径

返回
`TestDevice.MicrodroidBuilder`

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

设置 instance.img 文件路径。

参数
`instanceImgPath`	`String`

返回
`TestDevice.MicrodroidBuilder`

MemorystoreMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

设置提供给虚拟机的 RAM 容量。如果此值为 0 或为负数，则将使用默认值。

参数
`memoryMib`	`int`

返回
`TestDevice.MicrodroidBuilder`

卡数

public TestDevice.MicrodroidBuilder numCpus (int num)

设置虚拟机中的 vCPU 数量。默认值为 1。

仅在 Android T 中受支持。

参数
`num`	`int`

返回
`TestDevice.MicrodroidBuilder`

受保护的虚拟机

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

设置虚拟机是否受保护。

参数
`isProtectedVm`	`boolean`

返回
`TestDevice.MicrodroidBuilder`

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

设置 adb 连接到 Microdroid TestDevice 的超时时间（以毫秒为单位）。

参数
`timeoutMs`	`long`：超时（以毫秒计）

返回
`TestDevice.MicrodroidBuilder`