W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

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

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

Znane bezpośrednie podklasy

GoogleTradefedSandbox

GoogleTradefedSandbox Wewnętrzna specjalizacja TradefedSandbox do wykorzystania w infrastrukturze laboratorium.

Kontener piaskownicy, który może uruchamiać wywołanie Trade Federation. TODO: Allow Options to be passed to the sandbox.

Podsumowanie

Stałe
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

Konstruktory publiczne
`TradefedSandbox()`

Metody publiczne
`String`	`createClasspath(File workingDir)` Utwórz ścieżkę klasy na podstawie środowiska i katalogu roboczego zwróconego przez `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Tryb specjalny odłączony od głównego uruchomienia: gdy konfiguracja nie występuje w procesie nadrzędnym, przełączamy się na uproszczony program uruchamiający, w którym próbujemy skonfigurować piaskownicę przy użyciu aktualnie znanych informacji i wypełnić katalog roboczy, aby w pełni utworzyć konfigurację w katalogu z wersją.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static Set<String>`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Na podstawie nazwy konfiguracji testu dopasuj dodatkowe cele kompilacji z dodatkowych celów kompilacji piaskownicy.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Przygotuj środowisko, aby piaskownica działała prawidłowo.
`static String[]`	`removeIncompatibleFlags(String[] args)`
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` Uruchom piaskownicę w ustawionym środowisku.
`void`	`tearDown()` Przywróć wszystkie stany, pliki lub środowiska, które mogły ulec zmianie.

Metody chronione
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)` Zrzuca globalną konfigurację odfiltrowaną z niektórych obiektów.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Przygotuj `IConfiguration`, które zostaną przekazane do podprocesu i będą sterować wykonaniem kontenera.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Przygotuj i zserializuj `IInvocationContext`.

Stałe

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Wartość stała: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Wartość stała: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Wartość stała: "SANDBOX_ENABLED"

Konstruktory publiczne

TradefedSandbox

public TradefedSandbox ()

Metody publiczne

createClasspath

public String createClasspath (File workingDir)

Utwórz ścieżkę klasy na podstawie środowiska i katalogu roboczego zwróconego przez getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

Parametry
`workingDir`	`File`: bieżący katalog roboczy piaskownicy.

Zwraca
`String`	Ścieżka klasy do użycia.

Zgłasza
`ConfigurationException`

createThinLauncherConfig

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

Tryb specjalny odłączony od głównego uruchomienia: gdy konfiguracja nie występuje w procesie nadrzędnym, przełączamy się na uproszczony program uruchamiający, w którym próbujemy skonfigurować piaskownicę przy użyciu aktualnie znanych informacji i wypełnić katalog roboczy, aby w pełni utworzyć konfigurację w katalogu z wersją.

Parametry
`args`	`String`: oryginalne argumenty wiersza poleceń.
`keyStoreClient`	`IKeyStoreClient`: bieżący klient magazynu kluczy, który będzie używany do tworzenia konfiguracji.
`runUtil`	`IRunUtil`: bieżący `IRunUtil` do uruchamiania poleceń hosta.
`globalConfig`	`File`: globalna konfiguracja, która będzie używana do uruchamiania podprocesów TF.

Zwraca
`IConfiguration`	Plik wskazujący plik XML konfiguracji TF dla obiektów NON_VERSIONED. Zwraca wartość null, jeśli nie można utworzyć konfiguracji cienkiego programu uruchamiającego.

getTradefedSandboxEnvironment

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

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

Zwraca
`File`

Zgłasza
`Exception`

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

Na podstawie nazwy konfiguracji testu dopasuj dodatkowe cele kompilacji z dodatkowych celów kompilacji piaskownicy.

Parametry
`configName`	`String`

Zwraca
`Set<String>`

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Przygotuj środowisko, aby piaskownica działała prawidłowo.

Parametry
`context`	`IInvocationContext`: bieżące wywołanie `IInvocationContext`.
`config`	`IConfiguration`: `IConfiguration` polecenia do uruchomienia.
`listener`	`ITestInvocationListener`: bieżące wywołanie `ITestInvocationListener`, do którego należy przekazać wyniki końcowe.

Zwraca
`Exception`	obiekt `Exception` zawierający przyczynę niepowodzenia lub wartość null, jeśli operacja się powiodła.

removeIncompatibleFlags

public static String[] removeIncompatibleFlags (String[] args)

Parametry
`args`	`String`

Zwraca
`String[]`

home run

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Uruchom piaskownicę w ustawionym środowisku.

Parametry
`info`	`TestInformation`: `TestInformation` opisujące wywołanie.
`config`	`IConfiguration`: `IConfiguration` polecenia do uruchomienia.
`logger`	`ITestLogger`: `ITestLogger`, w którym możemy zapisywać pliki dziennika.

Zwraca
`CommandResult`	`CommandResult` ze stanem uruchomienia piaskownicy i logami.

Zgłasza
`Throwable`

tearDown

public void tearDown ()

Przywróć wszystkie stany, pliki lub środowiska, które mogły ulec zmianie.

Metody chronione

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

Zrzuca globalną konfigurację odfiltrowaną z niektórych obiektów.

Parametry
`config`	`IConfiguration`
`exclusionPatterns`	`Set`

Zwraca
`File`

Zgłasza
`ConfigurationException`
`IOException`

getJava

protected String getJava ()

Zwraca
`String`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Przygotuj IConfiguration, które zostaną przekazane do podprocesu i będą sterować wykonaniem kontenera.

Parametry
`context`	`IInvocationContext`: bieżąca `IInvocationContext`.
`config`	`IConfiguration`: `IConfiguration` do przygotowania.
`listener`	`ITestInvocationListener`: bieżące wywołanie `ITestInvocationListener`.

Zwraca
`Exception`	wyjątek, jeśli coś poszło nie tak, w przeciwnym razie wartość null.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Przygotuj i zserializuj plik IInvocationContext.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` do przygotowania.
`config`	`IConfiguration`: `IConfiguration` piaskownicy.

Zwraca
`File`	zserializowany `IInvocationContext`.

Zgłasza
	java.io.IOException
`IOException`