Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

Penampung sandbox yang dapat menjalankan pemanggilan Trade Federation. TODO: Izinkan Opsi diteruskan ke sandbox.

Ringkasan

Kolom
`public static final String`	`EXTRA_TARGET_LAB`
`public static final String`	`GENERAL_TESTS_ZIP`
`public static final String`	`SANDBOX_ENABLED`

Konstruktor publik
`TradefedSandbox()`

Metode publik
`String`	`createClasspath(File workingDir)` Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh `ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Mode khusus terputus dari operasi utama: Jika konfigurasi tampaknya tidak ada di induk, kita akan kembali ke peluncur tipis tempat kita mencoba menyiapkan sandbox dengan informasi yang saat ini diketahui dan mengisi direktori kerja untuk membuat konfigurasi sepenuhnya di dir berversi.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Dengan nama konfigurasi pengujian, cocokkan target build tambahan dari target build tambahan Sandbox.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Siapkan lingkungan agar sandbox berjalan dengan benar.
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` Jalankan sandbox dengan lingkungan yang telah ditetapkan.
`void`	`tearDown()` Bersihkan status, file, atau lingkungan apa pun yang mungkin telah diubah.

Metode yang dilindungi
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Dump konfigurasi global yang difilter dari beberapa objek.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Siapkan `IConfiguration` yang akan diteruskan ke subproses dan akan mendorong eksekusi penampung.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Siapkan dan serialisasi `IInvocationContext`.

Kolom

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Konstruktor publik

TradefedSandbox

public TradefedSandbox ()

Metode publik

createClasspath

public String createClasspath (File workingDir)

Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

Parameter
`workingDir`	`File`: direktori kerja saat ini untuk sandbox.

Hasil
`String`	Jalur kelas yang akan digunakan.

Menampilkan
`ConfigurationException`

createThinLauncherConfig

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

Mode khusus terputus dari operasi utama: Jika konfigurasi tampaknya tidak ada di induk, kita akan kembali ke peluncur tipis tempat kita mencoba menyiapkan sandbox dengan informasi yang saat ini diketahui dan mengisi direktori kerja untuk membuat konfigurasi sepenuhnya di dir berversi.

Parameter
`args`	`String`: Argumen command line asli.
`keyStoreClient`	`IKeyStoreClient`: klien keystore saat ini yang akan digunakan untuk membuat konfigurasi.
`runUtil`	`IRunUtil`: `IRunUtil` saat ini untuk menjalankan perintah host.
`globalConfig`	`File`: Konfigurasi global yang akan digunakan untuk menjalankan subproses TF.

Hasil
`IConfiguration`	File yang mengarah ke XML konfigurasi TF untuk objek NON_VERSIONED. Menampilkan null jika tidak ada konfigurasi peluncur tipis yang dapat dibuat.

getTradefedSandboxEnvironment

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

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

Hasil
`File`

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

Dengan nama konfigurasi pengujian, cocokkan target build tambahan dari target build tambahan Sandbox.

Parameter
`configName`	`String`

Hasil

prepareEnvironment

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

Siapkan lingkungan agar sandbox berjalan dengan benar.

Parameter
`context`	`IInvocationContext`: pemanggilan saat ini `IInvocationContext`.
`config`	`IConfiguration`: `IConfiguration` untuk perintah yang akan dijalankan.
`listener`	`ITestInvocationListener`: pemanggilan saat ini `ITestInvocationListener` tempat hasil akhir harus disalurkan.

Hasil
`Exception`	`Exception` yang berisi kegagalan. atau Null jika berhasil.

lari

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

Jalankan sandbox dengan lingkungan yang telah ditetapkan.

Parameter
`info`	`TestInformation`: `TestInformation` yang menjelaskan pemanggilan
`config`	`IConfiguration`: `IConfiguration` untuk perintah yang akan dijalankan.
`logger`	`ITestLogger`: `ITestLogger` tempat kita dapat mencatat file ke dalam log.

Hasil
`CommandResult`	`CommandResult` dengan status sandbox yang berjalan dan log.

tearDown

public void tearDown ()

Bersihkan status, file, atau lingkungan apa pun yang mungkin telah diubah.

Metode yang dilindungi

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Dump konfigurasi global yang difilter dari beberapa objek.

Parameter
`config`	`IConfiguration`
`exclusionPatterns`

Hasil
`File`

Menampilkan
`ConfigurationException`

getJava

protected String getJava ()

Hasil
`String`

prepareConfiguration

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

Siapkan IConfiguration yang akan diteruskan ke subproses dan akan mendorong eksekusi penampung.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` saat ini.
`config`	`IConfiguration`: `IConfiguration` yang akan disiapkan.
`listener`	`ITestInvocationListener`: Pemanggilan saat ini `ITestInvocationListener`.

Hasil
`Exception`	Exception jika terjadi masalah, null jika tidak.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Siapkan dan serialisasi IInvocationContext.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` yang akan disiapkan.
`config`	`IConfiguration`: `IConfiguration` sandbox.

Hasil
`File`	`IInvocationContext` serial.

Menampilkan
	IOException