ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


Schnittstelle, die eine Sandbox definiert, die zum Ausführen eines Aufrufs verwendet werden kann.

Zusammenfassung

Öffentliche Methoden

abstract String createClasspath (File workingDir)

Erstellen Sie einen Klassenpfad basierend auf der Umgebung und dem von getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) zurückgegebenen Arbeitsverzeichnis.

abstract IConfiguration createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

Sondermodus getrennt vom Hauptlauf: Wenn eine Konfiguration im übergeordneten Verzeichnis nicht vorhanden zu sein scheint, greifen wir auf den Thin Launcher zurück, wo wir versuchen, die Sandbox mit aktuell bekannten Informationen einzurichten und das Arbeitsverzeichnis zu füllen, um die Konfiguration vollständig im versionierten Verzeichnis zu erstellen .

abstract File getTradefedSandboxEnvironment (IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)

Gibt die Sandbox-Umgebungs-TF zurück, die basierend auf den Befehlszeilenargumenten verwendet werden soll.

abstract Exception prepareEnvironment (IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

Bereiten Sie die Umgebung für die ordnungsgemäße Ausführung der Sandbox vor.

abstract CommandResult run ( IConfiguration configuration, ITestLogger logger)

Führen Sie die Sandbox mit der festgelegten Umgebung aus.

abstract void tearDown ()

Bereinigen Sie alle Zustände, Dateien oder Umgebungen, die möglicherweise geändert wurden.

Öffentliche Methoden

createClasspath

public abstract String createClasspath (File workingDir)

Erstellen Sie einen Klassenpfad basierend auf der Umgebung und dem von getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) zurückgegebenen Arbeitsverzeichnis.

Parameter
workingDir File : das aktuelle Arbeitsverzeichnis für die Sandbox.

Kehrt zurück
String Der zu verwendende Klassenpfad.

Würfe
ConfigurationException

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Sondermodus getrennt vom Hauptlauf: Wenn eine Konfiguration im übergeordneten Verzeichnis nicht vorhanden zu sein scheint, greifen wir auf den Thin Launcher zurück, wo wir versuchen, die Sandbox mit aktuell bekannten Informationen einzurichten und das Arbeitsverzeichnis zu füllen, um die Konfiguration vollständig im versionierten Verzeichnis zu erstellen .

Parameter
args String : Die ursprünglichen Befehlszeilenargumente.

keyStoreClient IKeyStoreClient : der aktuelle Keystore-Client, der zum Erstellen von Konfigurationen verwendet werden soll.

runUtil IRunUtil : das aktuelle IRunUtil zum Ausführen von Hostbefehlen.

globalConfig File : Die globale Konfiguration, die zum Ausführen von Unterprozessen von TF verwendet werden soll.

Kehrt zurück
IConfiguration eine Datei, die auf die Konfigurations-XML von TF für NON_VERSIONED-Objekte verweist. Gibt null zurück, wenn keine Thin-Launcher-Konfiguration erstellt werden konnte.

getTradefedSandboxEnvironment

public abstract File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

Gibt die Sandbox-Umgebungs-TF zurück, die basierend auf den Befehlszeilenargumenten verwendet werden soll.

Parameter
context IInvocationContext : der IInvocationContext des übergeordneten Elements.

nonVersionedConfig IConfiguration : Die IConfiguration , die die nicht versionierten Objekte darstellt.

args String : die Befehlszeilenargumente.

Kehrt zurück
File ein ERROR(/File) -Verzeichnis, das die TF-Sandbox-Umgebungs-JARs enthält.

PrepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

Bereiten Sie die Umgebung für die ordnungsgemäße Ausführung der Sandbox vor.

Parameter
context IInvocationContext : der aktuelle Aufruf IInvocationContext .

configuration IConfiguration : die IConfiguration für den auszuführenden Befehl.

listener ITestInvocationListener : der aktuelle Aufruf ITestInvocationListener , an den die Endergebnisse weitergeleitet werden sollen.

Kehrt zurück
Exception eine Exception , die den Fehler enthält. oder Null, wenn erfolgreich.

laufen

public abstract CommandResult run (IConfiguration configuration, 
                ITestLogger logger)

Führen Sie die Sandbox mit der festgelegten Umgebung aus.

Parameter
configuration IConfiguration : die IConfiguration für den auszuführenden Befehl.

logger ITestLogger : ein ITestLogger , mit dem wir Dateien protokollieren können.

Kehrt zurück
CommandResult ein CommandResult mit dem Status der Sandbox-Ausführung und Protokollen.

abreißen

public abstract void tearDown ()

Bereinigen Sie alle Zustände, Dateien oder Umgebungen, die möglicherweise geändert wurden.