ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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.