為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

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

用於建立 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 的路徑。
`TestDevice.MicrodroidBuilder`	`enableEarlycon(boolean enableEarlycon)` 為這個 VM 啟用 earlycon 記錄。
`TestDevice.MicrodroidBuilder`	`forceStartAdbd(boolean forceStartAdbd)` 在 `vm run` 和 `adb forward` 之間強制呼叫 `vm start-adbd`。注意：在舊版 API 級別 (SDK 36 之前)，這個函式不會執行任何作業。
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` 為 APK 中指定的 apkPath 和酬載設定檔建立 Microdroid 建構工具。
`static TestDevice.MicrodroidBuilder`	`fromDevicePathWithPayloadBinaryName(String apkPath, String payloadBinaryName)` 為 APK 中指定的 apkPath 和酬載二進位檔名稱建立 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)` 設定要提供給 VM 的 RAM 數量。
`TestDevice.MicrodroidBuilder`	`name(String name)` 設定這個 VM 的名稱。
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` 設定 VM 中的 vCPU 數量。
`TestDevice.MicrodroidBuilder`	`os(String os)` 使用非預設的 Microdroid OS 變體版本。
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` 設定是否要保護 VM。
`TestDevice.MicrodroidBuilder`	`ramdump(boolean useRamdump)` 設定是否要關閉 ramdump 的當機核心。
`TestDevice.MicrodroidBuilder`	`setAdbConnectTimeoutMs(long timeoutMs)` 以毫秒為單位，設定 adb 連線至 microdroid TestDevice 的逾時時間。

公用方法

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

新增要指派給 Microdroid 的裝置。

參數
`sysfsNode`	`String`：要指派的 sysfs 節點路徑

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

addBootFile

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

新增要推送至 ERROR(/#TEST_ROOT) 的開機檔案。

如果啟動 Microdroid 需要檔案，請使用這個方法。否則請使用 TestDevice.pushFile。

參數
`localFile`	`File`：主機上的本機檔案
`remoteFileName`	`String`：裝置上的遠端檔案名稱

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

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`	微型機器人建構工具。

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`

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

為這個 VM 啟用 earlycon 記錄。

注意：在舊版 API 級別 (SDK 36 之前)，這個函式不會執行任何作業。

參數
`enableEarlycon`	`boolean`

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

在 `vm run` 和 `adb forward` 之間強制呼叫 `vm start-adbd`。

注意：在舊版 API 級別 (SDK 36 之前)，這個函式不會執行任何作業。

參數
`forceStartAdbd`	`boolean`

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

fromDevicePath

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

為指定 apkPath 和 APK 中的酬載設定檔建立 Microdroid 建構工具。

參數
`apkPath`	`String`
`configPath`	`String`

傳回
`TestDevice.MicrodroidBuilder`

fromDevicePathWithPayloadBinaryName

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

為指定的 apkPath 和 APK 中的酬載二進位檔名稱建立 Microdroid 建構工具。

參數
`apkPath`	`String`
`payloadBinaryName`	`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`	微型機器人建構工具。

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)

設定要提供給 VM 的 RAM 容量。如果為零或負數，系統會使用預設值。

參數
`memoryMib`	`int`

傳回
`TestDevice.MicrodroidBuilder`

名稱

public TestDevice.MicrodroidBuilder name (String name)

設定這個 VM 的名稱。

參數
`name`	`String`

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

設定 VM 中的 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)

設定是否要保護 VM。

參數
`isProtectedVm`	`boolean`

傳回
`TestDevice.MicrodroidBuilder`

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

設定是否要關閉 ramdump 的當機核心。

參數
`useRamdump`	`boolean`

傳回
`TestDevice.MicrodroidBuilder`	微型機器人建構工具。

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

以毫秒為單位，設定 adb 連線至 microdroid TestDevice 的逾時時間。

為避免測試停止回應，這個值應為正數。

參數
`timeoutMs`	`long`：逾時時間 (以毫秒為單位)

傳回
`TestDevice.MicrodroidBuilder`