自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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)` 設定要提供給 VM 的 RAM 容量。
`TestDevice.MicrodroidBuilder`	`name(String name)` 設定此 VM 的名稱。
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` 設定虛擬機器中的 vCPU 數量。
`TestDevice.MicrodroidBuilder`	`os(String os)` 使用非預設的 Microdroid OS 變化版本。
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` 設定是否要保護 VM。
`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 的轉儲路徑。

支援的值：空值和「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)

This method is deprecated.
使用 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)

設定 VM 的 RAM 容量。如果為零或負值，則會使用預設值。

參數
`memoryMib`	`int`

傳回
`TestDevice.MicrodroidBuilder`

name

public TestDevice.MicrodroidBuilder name (String name)

設定此 VM 的名稱。

參數
`name`	`String`

傳回
`TestDevice.MicrodroidBuilder`	MicroDroid 建構工具。

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`

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

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

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

傳回
`TestDevice.MicrodroidBuilder`