Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Bekannte indirekte Unterklassen

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Interne Spezialisierung von `TradefedSandbox`, die in der Lab-Infrastruktur verwendet werden soll.
TradefedSandbox	Sandbox-Container, in dem ein Trade Federation-Aufruf ausgeführt werden kann.

Schnittstelle, die eine Sandbox definiert, in der ein Aufruf ausgeführt werden kann.

Zusammenfassung

Öffentliche Methoden
`abstract String`	`createClasspath(File workingDir)` Erstellen Sie einen Klassenpfad basierend auf der Umgebung und dem Arbeitsverzeichnis, die von `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])` zurückgegeben werden.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Sondermodus – Verbindung zum Hauptlaufwerk getrennt: Wenn eine Konfiguration im übergeordneten Element nicht vorhanden ist, wird auf den Thin Launcher zurückgegriffen. Dort wird versucht, die Sandbox mit den aktuell bekannten Informationen einzurichten und das Arbeitsverzeichnis zu füllen, um die Konfiguration vollständig im versionierten Verzeichnis zu erstellen.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Ein Unterschritt von `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)`, in dem Tests ermittelt werden, wenn `SandboxOptions.shouldUseTestDiscovery()` aktiviert ist.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Untergeordneter Schritt von `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)`, in dem zusätzliche Dateien abgerufen werden, die für die Sandbox erforderlich sind.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Gibt den TF der Sandbox-Umgebung zurück, der 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 vor, damit 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 Klassenpfad basierend auf der Umgebung und dem Arbeitsverzeichnis, die von getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) zurückgegeben werden.

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

Gibt Folgendes zurück:
`String`	Der zu verwendende Klassenpfad.

Löst aus
`ConfigurationException`

createThinLauncherConfig

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

Sondermodus – Verbindung zum Hauptlaufwerk getrennt: Wenn eine Konfiguration im übergeordneten Element nicht vorhanden ist, wird auf den Thin Launcher zurückgegriffen. Dort wird versucht, die Sandbox mit den 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`: die aktuelle `IRunUtil` zum Ausführen von Hostbefehlen.
`globalConfig`	`File`: Die globale Konfiguration, die zum Ausführen von Unterprozessen von TF verwendet werden soll.

Gibt Folgendes zurück:
`IConfiguration`	Eine Datei, die auf die Konfigurations-XML von TF für Objekte ohne Versionsangabe verweist. Gibt „null“ zurück, wenn keine Thin Launcher-Konfiguration erstellt werden konnte.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Ein Unterschritt von prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), in dem Tests ermittelt werden, wenn SandboxOptions.shouldUseTestDiscovery() aktiviert ist.

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

Gibt Folgendes zurück:
`Map<String, List<String>>`	Die Karte der ermittelten Tests oder „null“, wenn sie nicht unterstützt werden oder fehlgeschlagen sind.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parameter
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Gibt Folgendes zurück:
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

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

Untergeordneter Schritt von prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), in dem zusätzliche Dateien abgerufen werden, die für die Sandbox erforderlich sind.

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

Gibt Folgendes zurück:
`IFolderBuildInfo`	den abgerufenen Build für die zusätzlichen Dateien in der Sandbox.

Löst aus
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

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

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

Parameter
`context`	`IInvocationContext`: die `IInvocationContext` des übergeordneten Elements.
`nonVersionedConfig`	`IConfiguration`: das `IConfiguration`, das die nicht versionierten Objekte darstellt.
`args`	`String`: die Befehlszeilenargumente.

Gibt Folgendes zurück:
`File`	ein `File`-Verzeichnis mit den TF-Sandbox-Umgebungs-Jars.

Löst aus
`Exception`

getTradefedSandboxEnvironment

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

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

Gibt Folgendes zurück:
`File`

Löst aus
`Exception`

prepareEnvironment

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

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

Parameter
`context`	`IInvocationContext`: der aktuelle Aufruf `IInvocationContext`.
`configuration`	`IConfiguration`: die `IConfiguration` für den auszuführenden Befehl.
`listener`	`ITestInvocationListener`: Der aktuelle Aufruf `ITestInvocationListener`, in den endgültige Ergebnisse weitergeleitet werden sollen.

Gibt Folgendes zurück:
`Exception`	Ein `Exception` mit dem Fehler oder Null, wenn der Vorgang erfolgreich war.

run

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 den Aufruf beschreibt
`configuration`	`IConfiguration`: die `IConfiguration` für den auszuführenden Befehl.
`logger`	`ITestLogger`: ein `ITestLogger`, in dem wir Logdateien speichern können.

Gibt Folgendes zurück:
`CommandResult`	`CommandResult` mit dem Status des Sandbox-Laufs und den Logs.

Löst aus
`Throwable`

tearDown

public abstract void tearDown ()

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