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 Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada 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

Subclass tidak langsung yang umum

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Spesialisasi internal `TradefedSandbox` yang akan digunakan dalam infrastruktur lab.
TradefedSandbox	Container sandbox yang dapat menjalankan pemanggilan Trade Federation.

Antarmuka yang menentukan sandbox yang dapat digunakan untuk menjalankan pemanggilan.

Ringkasan

Metode publik
`abstract String`	`createClasspath(File workingDir)` Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Mode khusus terputus dari proses utama: Jika konfigurasi 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.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Sub-langkah `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` yang menemukan pengujian jika `SandboxOptions.shouldUseTestDiscovery()` diaktifkan.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Sub-langkah `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` yang mengambil file tambahan yang diperlukan untuk sandbox.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Menampilkan TF lingkungan sandbox yang akan digunakan berdasarkan argumen command line.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Siapkan lingkungan agar sandbox berjalan dengan benar.
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` Jalankan sandbox dengan lingkungan yang telah disetel.
`abstract void`	`tearDown()` Bersihkan status, file, atau lingkungan yang mungkin telah diubah.

Metode publik

createClasspath

public abstract String createClasspath (File workingDir)

Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

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

Hasil
`String`	Classpath yang akan digunakan.

Menampilkan
`ConfigurationException`

createThinLauncherConfig

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

Mode khusus terputus dari proses utama: Jika konfigurasi 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.

discoverTests

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

Sub-langkah prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) yang menemukan pengujian jika SandboxOptions.shouldUseTestDiscovery() diaktifkan.

Parameter
`context`	`IInvocationContext`: pemanggilan `IInvocationContext` saat ini.
`configuration`	`IConfiguration`: `IConfiguration` untuk perintah yang akan dijalankan.

Hasil
`Map<String, List<String>>`	Peta pengujian yang ditemukan atau null jika tidak didukung atau gagal.

discoverTests

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

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

Hasil
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

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

Sub-langkah prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) yang mengambil file tambahan yang diperlukan untuk sandbox.

Parameter
`context`	`IInvocationContext`: pemanggilan `IInvocationContext` saat ini.
`configuration`	`IConfiguration`: `IConfiguration` untuk perintah yang akan dijalankan.
`args`	`String`: argumen command line.

Hasil
`IFolderBuildInfo`	build yang diambil untuk file tambahan yang di-sandbox.

Menampilkan
	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)

Menampilkan TF lingkungan sandbox yang akan digunakan berdasarkan argumen command line.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` induk.
`nonVersionedConfig`	`IConfiguration`: `IConfiguration` yang merepresentasikan objek yang tidak berversi.
`args`	`String`: argumen command line.

Hasil
`File`	direktori `File` yang berisi JAR lingkungan sandbox TF.

Menampilkan
`Exception`

getTradefedSandboxEnvironment

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

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

Hasil
`File`

Menampilkan
`Exception`

prepareEnvironment

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

Siapkan lingkungan agar sandbox berjalan dengan benar.

Parameter
`context`	`IInvocationContext`: pemanggilan `IInvocationContext` saat ini.
`configuration`	`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 abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Jalankan sandbox dengan lingkungan yang telah disetel.

Parameter
`info`	`TestInformation`: `TestInformation` yang menjelaskan pemanggilan
`configuration`	`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.

Menampilkan
`Throwable`

tearDown

public abstract void tearDown ()

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