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) に push される起動用のファイルを追加。
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) カーネルに透過 Hugepage のヒントを出すかどうかを設定します。
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	setAdbConnectTimeoutMs(long timeoutMs) microdroid TestDevice への adb 接続のタイムアウトをミリ秒単位で設定します。

パブリック メソッド

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) に push される起動用のファイルを追加。

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 を設定します。形式は、vCPU を実行する CPU または CPU 範囲のカンマ区切りリストです。たとえば、ホスト CPU 0、1、2、3、5 を選択するには、「0,1-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) を使用します。

microdroid カーネルではなく GKI カーネルを使用

パラメータ
version	String: 使用する GKI バージョン

戻り値
TestDevice.MicrodroidBuilder

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

カーネルに Transparent Huge Page のヒントを提供するかどうかを設定します。

パラメータ
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)

microdroid TestDevice への adb 接続のタイムアウトをミリ秒単位で設定します。

パラメータ
timeoutMs	long: タイムアウト（ミリ秒）

戻り値
TestDevice.MicrodroidBuilder