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 より前)では、この関数は no-op です。

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

指定された apkPath と APK のペイロード構成ファイル用の Microdroid ビルダーを作成します。

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

指定された 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)

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

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)

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) にプッシュされる起動用のファイルを追加します。

microdroid の起動にファイルが必要な場合は、このメソッドを使用します。それ以外の場合は、TestDevice.pushFile を使用します。

パラメータ
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 範囲のカンマ区切りのリストです。たとえば、「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 より前)では、この関数は no-op です。

パラメータ
enableEarlycon boolean

戻り値
TestDevice.MicrodroidBuilder Microdroid ビルダー。

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

`vm run` と `adb forward` の間で `vm start-adbd` を強制的に呼び出す

注: 古い API レベル(SDK 36 より前)では、この関数は no-op です。

パラメータ
forceStartAdbd boolean

戻り値
TestDevice.MicrodroidBuilder Microdroid ビルダー。

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) を使用します。

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

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

戻り値
TestDevice.MicrodroidBuilder

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

透過的な 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

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

ramdump のクラッシュ カーネルをオフにするかどうかを設定します。

パラメータ
useRamdump boolean

戻り値
TestDevice.MicrodroidBuilder Microdroid ビルダー。

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

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

テストのハングを防ぐため、正の値にする必要があります。

パラメータ
timeoutMs long: タイムアウト(ミリ秒単位)

戻り値
TestDevice.MicrodroidBuilder