本頁面由 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)` 為 APK 中的指定 apkPath 和酬載設定檔建立 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)` 設定要提供給 VM 的 RAM 容量。
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` 設定 VM 中的 vCPU 數量。
`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)

將額外的 Idig 檔案新增至清單。

參數
`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`

CPU 相依性

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`

CPU 拓撲

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

設置 CPU 拓撲設定。支援的值：「one_cpu」和「match_host」。

參數
`cpuTopology`	`String`

傳回
`TestDevice.MicrodroidBuilder`

DebugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

設定偵錯層級。

支援的值：「無」和「完整」。Android T 也支援「app_only」。

參數
`debugLevel`	`String`

傳回
`TestDevice.MicrodroidBuilder`

從裝置路徑

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

為 APK 中的指定 apkPath 和酬載設定檔建立 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`：執行個體 ID 的路徑

傳回
`TestDevice.MicrodroidBuilder`

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

設定 instance.img 檔案路徑。

參數
`instanceImgPath`	`String`

傳回
`TestDevice.MicrodroidBuilder`

記憶體 Mib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

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

參數
`memoryMib`	`int`

傳回
`TestDevice.MicrodroidBuilder`

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

設定 VM 中的 vCPU 數量。預設值為 1。

僅適用於 Android T。

參數
`num`	`int`

傳回
`TestDevice.MicrodroidBuilder`

受保護的 VM

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

設定是否要保護 VM。

參數
`isProtectedVm`	`boolean`

傳回
`TestDevice.MicrodroidBuilder`

setAdbConnectTimeoutM

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

設定 ADB 連線至 microdroid TestDevice 的逾時時間 (以毫秒為單位)。

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

傳回
`TestDevice.MicrodroidBuilder`