Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Kuartal 2 dan Kuartal 4. Untuk membangun dan berkontribusi ke AOSP, sebaiknya gunakan android-latest-release, bukan aosp-main. Cabang manifes android-latest-release akan selalu merujuk pada rilis terbaru yang di-push ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

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

Ringkasan

Konstanta
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`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 proses utama: Jika konfigurasi tampaknya tidak ada di induk, kita akan kembali ke peluncur tipis tempat kita mencoba menyiapkan sandbox dengan informasi yang diketahui saat ini dan mengisi direktori kerja untuk membuat konfigurasi sepenuhnya di direktori versi.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Mengingat 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 disetel.
`void`	`tearDown()` Bersihkan semua status, file, atau lingkungan yang mungkin telah diubah.

Metode yang dilindungi
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Buang 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 container.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Siapkan dan serialkan `IInvocationContext`.

Konstanta

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Nilai Konstanta: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Nilai Konstanta: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Nilai Konstanta: "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`	Classpath yang akan digunakan.

Menampilkan
`ConfigurationException`

createThinLauncherConfig

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

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

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)

Mengingat 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 `IInvocationContext` saat ini.
`config`	`IConfiguration`: `IConfiguration` untuk perintah yang akan dijalankan.
`listener`	`ITestInvocationListener`: pemanggilan `ITestInvocationListener` saat ini 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 disetel.

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

Hasil
`CommandResult`	`CommandResult` dengan status dan log eksekusi sandbox.

tearDown

public void tearDown ()

Bersihkan semua status, file, atau lingkungan yang mungkin telah diubah.

Metode yang dilindungi

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Buang 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 container.

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

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

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Siapkan dan serialkan IInvocationContext.

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

Hasil
`File`	`IInvocationContext` yang diserialkan.

Menampilkan
	IOException