ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Benutzeroberfläche, die eine Sandbox definiert, die zum Ausführen eines Aufrufs verwendet werden kann.

Zusammenfassung

Öffentliche Methoden

abstract String createClasspath(File workingDir)

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

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

Sondermodus ohne Verbindung zum Hauptlauf: Wenn eine Konfiguration im übergeordneten Element nicht vorhanden ist, wechseln wir zum Thin Launcher, bei dem wir versuchen, die Sandbox mit den derzeit 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-Umgebung zurück, die anhand der Befehlszeilenargumente verwendet werden soll.

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

Bereiten Sie die Umgebung so vor, dass die Sandbox ordnungsgemäß ausgeführt werden kann.

abstract CommandResult run(IConfiguration configuration, ITestLogger logger)

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

abstract void tearDown()

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

Öffentliche Methoden

createClasspath

public abstract String createClasspath (File workingDir)

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

Parameter
workingDir File: das aktuelle Arbeitsverzeichnis für die Sandbox.
Returns
String Der zu verwendende Klassenpfad.

Ausgabe
ConfigurationException

createThinLauncherConfig

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

Sondermodus ohne Verbindung zum Hauptlauf: Wenn eine Konfiguration im übergeordneten Element nicht vorhanden ist, wechseln wir zum Thin Launcher, bei dem wir versuchen, die Sandbox mit den derzeit 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 Schlüsselspeicherclient, der zum Erstellen von Konfigurationen verwendet werden soll.
runUtil IRunUtil: Der aktuelle IRunUtil zum Ausführen von Hostbefehlen.
globalConfig File: Die globale Konfiguration, die zum Ausführen von TF-Unterprozessen verwendet werden soll.
Returns
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-Umgebung zurück, die anhand der Befehlszeilenargumente verwendet werden soll.

Parameter
context IInvocationContext: der IInvocationContext des übergeordneten Elements.
nonVersionedConfig IConfiguration: das IConfiguration, das die nicht versionierten Objekte darstellt.
args String: die Befehlszeilenargumente.
Returns
File ein ERROR(/File)-Verzeichnis mit den JAR-Dateien der TF-Sandbox-Umgebung.

prepareEnvironment

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

Bereiten Sie die Umgebung so vor, dass die Sandbox ordnungsgemäß ausgeführt werden kann.

Parameter
context IInvocationContext: die aktuelle Aufruf-ID IInvocationContext.
configuration IConfiguration: IConfiguration für den auszuführenden Befehl.
listener ITestInvocationListener: Die aktuelle Aufrufanfrage ITestInvocationListener, an die die endgültigen Ergebnisse gesendet werden sollen.
Returns
Exception Eine Exception mit dem Fehler oder Null, falls der Vorgang erfolgreich war.

Homerun

public abstract CommandResult run (IConfiguration configuration, 
                ITestLogger logger)

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

Parameter
configuration IConfiguration: IConfiguration für den auszuführenden Befehl.
logger ITestLogger: einen ITestLogger, in dem Dateien protokolliert werden können.
Returns
CommandResult eine CommandResult mit dem Status der Sandbox-Ausführung und den Protokollen.

tearDown

public abstract void tearDown ()

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