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 .

default discoverTests ( IInvocationContext context, IConfiguration configuration)

Ein Unterschritt von prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , der Tests erkennt, wenn SandboxOptions.shouldUseTestDiscovery() aktiviert ist.

default discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)

Unterschritt von prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , der zusätzliche für die Sandbox benötigte Dateien abruft.

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

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

default File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
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 ( TestInformation info, 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.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Ein Unterschritt von prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , der Tests erkennt, wenn SandboxOptions.shouldUseTestDiscovery() aktiviert ist.

Parameter
context IInvocationContext : der aktuelle Aufruf IInvocationContext .

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

Kehrt zurück
Die Karte der erkannten Tests oder null, wenn sie nicht unterstützt werden oder fehlgeschlagen sind.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parameter
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Kehrt zurück

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Unterschritt von prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , der zusätzliche für die Sandbox benötigte Dateien abruft.

Parameter
context IInvocationContext : der aktuelle Aufruf IInvocationContext .

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

args String : die Befehlszeilenargumente.

Kehrt zurück
IFolderBuildInfo der abgerufene Build für die zusätzlichen Sandbox-Dateien.

Würfe
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

public 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.

getTradefedSandboxEnvironment

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

Parameter
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Kehrt zurück
File

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 (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Parameter
info TestInformation : die TestInformation , die den Aufruf beschreibt

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.