Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Bekannte indirekte Unterklassen

TradefedSandbox

TradefedSandbox Sandbox-Container, in dem eine Trade Federation-Aufruf ausgeführt werden kann.

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.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Ein untergeordneter Schritt von `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)`, der prüft, ob `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)`, bei dem zusätzliche Dateien abgerufen werden, die für die Sandbox erforderlich sind.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Gibt die Sandbox-Umgebung zurück, die anhand der Befehlszeilenargumente 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 so vor, dass die Sandbox ordnungsgemäß ausgeführt werden kann.
`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 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.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Ein untergeordneter Schritt von prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener), der prüft, ob SandboxOptions.shouldUseTestDiscovery() aktiviert ist.

Parameter
`context`	`IInvocationContext`: die aktuelle Aufruf-ID `IInvocationContext`.
`configuration`	`IConfiguration`: `IConfiguration` für den auszuführenden Befehl.

Returns
	Die Zuordnung 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`

Returns

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), bei dem zusätzliche Dateien abgerufen werden, die für die Sandbox erforderlich sind.

Parameter
`context`	`IInvocationContext`: die aktuelle Aufruf-ID `IInvocationContext`.
`configuration`	`IConfiguration`: `IConfiguration` für den auszuführenden Befehl.
`args`	`String`: die Befehlszeilenargumente.

Returns
`IFolderBuildInfo`	den abgerufenen Build für die zusätzlichen Dateien in der Sandbox.

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

getTradefedSandboxEnvironment

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

Parameter
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Returns
`File`

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

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

Parameter
`info`	`TestInformation`: der `TestInformation`, der die Aufrufe beschreibt
`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.