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)

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

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 範圍例如:「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)

設定偵錯層級。

支援的值:「無」和「full」。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 容量。如果值為 0 或負數,則預設值為 0。 。

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