TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.TestDevice.MicrodroidBuilder

Ein Builder zum Erstellen eines Microdroid-Testgeräts.

Zusammenfassung

Öffentliche Methoden

TestDevice.MicrodroidBuilder addAssignableDevice(String sysfsNode)

Fügt ein Gerät hinzu, das einem Microdroid zugewiesen werden soll.

TestDevice.MicrodroidBuilder addBootFile(File localFile, String remoteFileName)

Fügt eine Datei für den Start hinzu, die an ERROR(/#TEST_ROOT) gesendet werden soll.

TestDevice.MicrodroidBuilder addExtraIdsigPath(String extraIdsigPath)

Fügt der Liste eine zusätzliche idsig-Datei hinzu.

TestDevice.MicrodroidBuilder addTestDeviceOption(String optionName, String valueText)

Legt eine TestDeviceOptions für das Microdroid-Testgerät fest.

ITestDevice build(TestDevice device)

Startet ein Micrdroid-Testgerät auf dem angegebenen Testgerät.

TestDevice.MicrodroidBuilder cpuAffinity(String affinity)

Gibt an, auf welchen Host-CPUs die vCPUs ausgeführt werden können.

TestDevice.MicrodroidBuilder cpuTopology(String cpuTopology)

Legt die CPU-Topologiekonfiguration fest.

TestDevice.MicrodroidBuilder debugLevel(String debugLevel)

Legt die Debugging-Ebene fest.

TestDevice.MicrodroidBuilder dumpDt(String dumpDt)

Legt den Pfad fest, in den der Gerätebaum-Blob geschrieben wird.

TestDevice.MicrodroidBuilder enableEarlycon(boolean enableEarlycon)

Aktiviert die Earlycon-Logs für diese VM.

TestDevice.MicrodroidBuilder forceStartAdbd(boolean forceStartAdbd)

Erzwingt den Aufruf von „vm start-adbd“ zwischen „vm run“ und „adb forward“

HINWEIS: Bei älteren API-Levels (vor SDK 36) ist diese Funktion ein No-Op.

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

Erstellt einen Microdroid-Builder für den angegebenen apkPath und die Nutzlastkonfigurationsdatei im APK.

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

Erstellt einen Microdroid-Builder für den angegebenen „apkPath“ und den Namen der Nutzlast-Binärdatei im APK.

static TestDevice.MicrodroidBuilder fromFile(File apkFile, String configPath)

Erstellt einen Microdroid-Builder für das angegebene APK und die Nutzlastkonfigurationsdatei im APK.

TestDevice.MicrodroidBuilder gki(String version)

Diese Methode wurde eingestellt. os(String) verwenden.

TestDevice.MicrodroidBuilder hugePages(boolean hintHugePages)

Legt fest, ob der Kernel auf transparente Hugepages hingewiesen werden soll.

TestDevice.MicrodroidBuilder instanceIdFile(String instanceIdPath)

Legt den instance_id-Pfad fest.

TestDevice.MicrodroidBuilder instanceImgFile(String instanceImgPath)

Legt den Dateipfad für „instance.img“ fest.

TestDevice.MicrodroidBuilder memoryMib(int memoryMib)

Legt die Menge an RAM fest, die der VM zugewiesen werden soll.

TestDevice.MicrodroidBuilder name(String name)

Legt den Namen für diese VM fest.

TestDevice.MicrodroidBuilder numCpus(int num)

Legt die Anzahl der vCPUs in der VM fest.

TestDevice.MicrodroidBuilder os(String os)

Verwendet eine nicht standardmäßige Variante des Microdroid-Betriebssystems.

TestDevice.MicrodroidBuilder protectedVm(boolean isProtectedVm)

Legt fest, ob die VM geschützt wird.

TestDevice.MicrodroidBuilder ramdump(boolean useRamdump)

Legt fest, ob der Crash-Kernel für RAM-Dumps deaktiviert werden soll.

TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs(long timeoutMs)

Legt das Zeitlimit für die adb-Verbindung zum Microdroid-Testgerät in Millisekunden fest.

Öffentliche Methoden

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

Fügt ein Gerät hinzu, das einem Microdroid zugewiesen werden soll.

Parameter
sysfsNode String: Der Pfad zum zuzuweisenden sysfs-Knoten.
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

addBootFile

public TestDevice.MicrodroidBuilder addBootFile (File localFile, 
                String remoteFileName)

Fügt eine Datei für den Start hinzu, die an ERROR(/#TEST_ROOT) gesendet werden soll.

Verwenden Sie diese Methode, wenn eine Datei zum Booten von Microdroid erforderlich ist. Verwenden Sie andernfalls TestDevice.pushFile.

Parameter
localFile File: Die lokale Datei auf dem Host
remoteFileName String: Der Name der Remote-Datei auf dem Gerät
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

Fügt der Liste eine zusätzliche idsig-Datei hinzu.

Parameter
extraIdsigPath String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

addTestDeviceOption

public TestDevice.MicrodroidBuilder addTestDeviceOption (String optionName, 
                String valueText)

Legt eine TestDeviceOptions für das Microdroid-Testgerät fest.

Parameter
optionName String: Der Name der TestDeviceOption, die festgelegt werden soll.
valueText String: Der Wert
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

Build

public ITestDevice build (TestDevice device)

Startet ein Micrdroid-TestDevice auf dem angegebenen TestDevice.

Parameter
device TestDevice

Gibt Folgendes zurück:
ITestDevice

Löst aus
DeviceNotAvailableException

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

Gibt an, auf welchen Host-CPUs die vCPUs ausgeführt werden können. Das Format ist eine durch Kommas getrennte Liste von CPUs oder CPU-Bereichen, auf denen vCPUs ausgeführt werden sollen, z. B. „0,1–3,5“ für die Auswahl der Host-CPUs 0, 1, 2, 3 und 5. Alternativ kann dies eine durch Doppelpunkte getrennte Liste von Zuweisungen von vCPU zu Host-CPU sein, z. B. „0=0:1=1:2=2“, um vCPU 0 der Host-CPU 0 zuzuweisen usw.

Wird nur in Android T unterstützt.

Parameter
affinity String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

Legt die CPU-Topologiekonfiguration fest. Unterstützte Werte: „one_cpu“ und „match_host“.

Parameter
cpuTopology String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

Legt die Debugging-Ebene fest.

Unterstützte Werte: „none“ und „full“. Android T unterstützt auch „app_only“.

Parameter
debugLevel String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

Legt den Pfad fest, in den der Gerätebaum-Blob geschrieben wird.

Unterstützte Werte: „null“ und „path“.

Parameter
dumpDt String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

Aktiviert die Earlycon-Logs für diese VM.

HINWEIS: Bei älteren API-Levels (vor SDK 36) ist diese Funktion ein No-Op.

Parameter
enableEarlycon boolean

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

Erzwingt den Aufruf von „vm start-adbd“ zwischen „vm run“ und „adb forward“

HINWEIS: Bei älteren API-Levels (vor SDK 36) ist diese Funktion ein No-Op.

Parameter
forceStartAdbd boolean

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

fromDevicePath

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

Erstellt einen Microdroid-Builder für den angegebenen apkPath und die Nutzlastkonfigurationsdatei im APK.

Parameter
apkPath String

configPath String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

fromDevicePathWithPayloadBinaryName

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

Erstellt einen Microdroid-Builder für den angegebenen apkPath und den Namen der Nutzlast-Binärdatei im APK.

Parameter
apkPath String

payloadBinaryName String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

fromFile

public static TestDevice.MicrodroidBuilder fromFile (File apkFile, 
                String configPath)

Erstellt einen Microdroid-Builder für das angegebene APK und die Nutzlastkonfigurationsdatei im APK.

Parameter
apkFile File

configPath String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

gki

public TestDevice.MicrodroidBuilder gki (String version)

Diese Methode wurde eingestellt.
Verwenden Sie os(String).

GKI-Kernel anstelle des Microdroid-Kernels verwenden

Parameter
version String: Die zu verwendende GKI-Version
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

Legt fest, ob der Kernel auf transparente Hugepages hingewiesen werden soll.

Parameter
hintHugePages boolean

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

Legt den instance_id-Pfad fest.

Parameter
instanceIdPath String: Pfad zur instanceId
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

Legt den Dateipfad für „instance.img“ fest.

Parameter
instanceImgPath String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

Legt die Menge an RAM fest, die der VM zugewiesen werden soll. Wenn der Wert null oder negativ ist, wird der Standardwert verwendet.

Parameter
memoryMib int

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

Name

public TestDevice.MicrodroidBuilder name (String name)

Legt den Namen für diese VM fest.

Parameter
name String

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

Legt die Anzahl der vCPUs in der VM fest. Der Standardwert ist 1.

Wird nur in Android T unterstützt.

Parameter
num int

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

os

public TestDevice.MicrodroidBuilder os (String os)

Verwendet eine nicht standardmäßige Variante des Microdroid-Betriebssystems.

Parameter
os String: Die zu verwendende Microdroid-Betriebssystemversion
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

Legt fest, ob die VM geschützt wird.

Parameter
isProtectedVm boolean

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

Legt fest, ob der Crash-Kernel für RAM-Dumps deaktiviert werden soll.

Parameter
useRamdump boolean

Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder des Microdroid-Builders.

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

Legt das Zeitlimit für die adb-Verbindung zum Microdroid-Testgerät in Millisekunden fest.

Dieser Wert sollte positiv sein, um zu verhindern, dass der Test hängen bleibt.

Parameter
timeoutMs long: Das Zeitlimit in Millisekunden
Gibt Folgendes zurück:
TestDevice.MicrodroidBuilder