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.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subclass tidak langsung yang umum

TradefedSandbox

TradefedSandbox Penampung 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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`abstract 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.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Sub-langkah `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` yang menemukan pengujian jika `SandboxOptions.shouldUseTestDiscovery()` diaktifkan.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Sub-langkah `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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 ditetapkan.
`abstract void`	`tearDown()` Bersihkan status, file, atau lingkungan apa pun yang mungkin telah diubah.

Metode publik

createClasspath

public abstract String createClasspath (File workingDir)

Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh 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 abstract 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.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Sub-langkah prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang menemukan pengujian jika SandboxOptions.shouldUseTestDiscovery() diaktifkan.

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

Hasil
	Peta pengujian yang ditemukan atau null jika tidak didukung atau gagal.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Hasil

fetchSandboxExtraArtifacts

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

Sub-langkah prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang mengambil file tambahan yang diperlukan untuk sandbox.

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

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

Menampilkan
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOException
`BuildRetrievalError`
`ConfigurationException`

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 mewakili objek tanpa versi.
`args`	`String`: argumen command line.

Hasil
`File`	direktori `ERROR(/File)` yang berisi jar lingkungan sandbox TF.

getTradefedSandboxEnvironment

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

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

Hasil
`File`

prepareEnvironment

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

Siapkan lingkungan agar sandbox berjalan dengan benar.

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

Jalankan sandbox dengan lingkungan yang telah ditetapkan.

Parameter
`info`	`TestInformation`: `TestInformation` yang menjelaskan pemanggilan
`configuration`	`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 abstract void tearDown ()

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