自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 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)` 设置调试级别。
`TestDevice.MicrodroidBuilder`	`dumpDt(String dumpDt)` 设置要将设备树 blob 转储到的路径。
`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)` 此方法已废弃。使用 `os(String)`。
`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`	`name(String name)` 为此虚拟机设置名称。
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` 设置虚拟机中的 vCPU 数量。
`TestDevice.MicrodroidBuilder`	`os(String os)` 使用 Microdroid OS 的非默认变体。
`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 上运行。格式为以英文逗号分隔的 CPU 或 CPU 范围列表，用于运行 vCPU。例如，“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`

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

设置将要将设备树 blob 转储到的路径。

支持的值：null 和“path”。

参数
`dumpDt`	`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)

此方法已废弃。
使用 os(String)。

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

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

返回
`TestDevice.MicrodroidBuilder`

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

设置是否向内核提示透明巨型页面。

参数
`hintHugePages`	`boolean`

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器。

instanceIdFile

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`

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

设置要分配给虚拟机的 RAM 量。如果此值为零或负数，则系统会使用默认值。

参数
`memoryMib`	`int`

返回
`TestDevice.MicrodroidBuilder`

name

public TestDevice.MicrodroidBuilder name (String name)

为此虚拟机设置名称。

参数
`name`	`String`

返回
`TestDevice.MicrodroidBuilder`	Microdroid 构建器。

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

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

仅在 Android T 中受支持。

参数
`num`	`int`

返回
`TestDevice.MicrodroidBuilder`

os

public TestDevice.MicrodroidBuilder os (String os)

使用 Microdroid OS 的非默认变体。

参数
`os`	`String`：要使用的 Microdroid OS 版本

返回
`TestDevice.MicrodroidBuilder`

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

设置是否保护虚拟机。

参数
`isProtectedVm`	`boolean`

返回
`TestDevice.MicrodroidBuilder`

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

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

参数
`timeoutMs`	`long`：超时（以毫秒为单位）

返回
`TestDevice.MicrodroidBuilder`